community.general.gandi_livedns 模块 – 管理 Gandi LiveDNS 记录

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.gandi_livedns。

community.general 2.3.0 中的新增功能

概要 

通过 Gandi LiveDNS API 管理 DNS 记录，请参阅文档：https://doc.livedns.gandi.net/。

参数 

参数	注释
api_key 字符串	帐户 API 令牌。请注意，这些类型的密钥已弃用，并且可能会在某些时候停止工作。请改用个人访问令牌。必须指定 `personal_access_token` 和 `api_key` 中的一个。
domain 字符串 / 必需	要使用的域名（例如，“example.com”）。
personal_access_token 字符串在 community.general 9.0.0 中添加	范围 API 令牌。必须指定 `personal_access_token` 和 `api_key` 中的一个。
record 字符串 / 必需	要添加的记录。
state 字符串	记录是否应该存在。选择 `"absent"` `"present"` ←（默认）
ttl 整数	为新记录提供的 TTL。当 `state=present` 时必需。
type 字符串 / 必需	要创建的 DNS 记录的类型。
values 列表 / 元素=字符串	记录值。当 `state=present` 时必需。

属性 

属性	支持	描述
check_mode	支持: 完整	可以在 `check_mode` 中运行，并返回已更改的状态预测，而无需修改目标。
diff_mode	支持: 无	当处于差异模式时，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Create a test A record to point to 127.0.0.1 in the my.com domain
  community.general.gandi_livedns:
    domain: my.com
    record: test
    type: A
    values:
    - 127.0.0.1
    ttl: 7200
    personal_access_token: dummytoken
  register: record

- name: Create a mail CNAME record to www.my.com domain
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    values:
    - www
    ttl: 7200
    personal_access_token: dummytoken
    state: present

- name: Change its TTL
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    values:
    - www
    ttl: 10800
    personal_access_token: dummytoken
    state: present

- name: Delete the record
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    personal_access_token: dummytoken
    state: absent

- name: Use a (deprecated) API Key
  community.general.gandi_livedns:
    domain: my.com
    record: test
    type: A
    values:
    - 127.0.0.1
    ttl: 7200
    api_key: dummyapikey

返回值 

常见的返回值记录在这里，以下是此模块特有的字段

键	描述
record 字典	包含记录数据的字典。返回: 成功，记录删除时除外
domain 字符串	与记录关联的域名。返回: 成功示例: `"my.com"`
record 字符串	记录名称。返回: 成功示例: `"www"`
ttl 整数	记录的生存时间。返回: 成功示例: `300`
type 字符串	记录类型。返回: 成功示例: `"A"`
values 列表 / 元素=字符串	记录内容（详细信息取决于记录类型）。返回: 成功示例: `["192.0.2.91", "192.0.2.92"]`

作者

Gregory Thiemonge (@gthiemonge)