community.dns.hetzner_dns_record_sets 模块 – 在 Hetzner DNS 服务中批量同步 DNS 记录集
注意
此模块是 community.dns 集合(版本 3.1.0)的一部分。
如果您正在使用 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.dns
。
要在 playbook 中使用它,请指定:community.dns.hetzner_dns_record_sets
。
community.dns 2.0.0 中的新功能
概要
在 Hetzner DNS 服务中批量同步 DNS 记录集。
可以通过为该记录集指定
record_sets[].ignore=true
来忽略某些记录集。该模块允许一次设置、修改和删除多个 DNS 记录集。
使用
prune
选项,还可以删除模块参数中未提及的现有记录集。这样,可以将 DNS 区域的预期状态与预期状态同步。
参数
参数 |
注释 |
---|---|
确定何时开始使用批量操作的阈值。 默认值 2 表示如果计划了 2 个或更多同类操作,并且 API 支持此类操作的批量操作,则将使用它们。 默认值: |
|
Hetzner API 的令牌。 如果未提供,将从环境变量 |
|
区域中应存在的记录。 |
|
如果设置为 当 选项
|
|
DNS 记录的前缀。 这是 必须指定 |
|
要创建或删除的完整 DNS 记录。 必须指定 |
|
新记录的 TTL,以秒为单位。 |
|
要创建或删除的 DNS 记录的类型。 选项
|
|
创建 DNS 记录时的新值。 允许 YAML 列表或多个以逗号分隔的值。 删除记录时,必须指定该记录的所有值,否则将不会被删除。 当 |
|
是否将数字转义序列 ( 默认值在 community.dns 3.0.0 中更改为 选项
|
|
确定 TXT 条目值如何在 API 和此模块的输入和输出之间转换。 值 值 值 默认值 注意:转换代码假定值为 UTF-8 编码。如果需要其他编码,请使用 选项
|
|
属性
属性 |
支持 |
描述 |
---|---|---|
操作组: community.dns.hetzner 在 community.dns 2.4.0 中添加。 |
在 |
|
支持: 完整 |
可以在 |
|
支持: 完整 |
在差异模式下,将返回有关已更改(或可能需要在 |
注释
注意
对于
CNAME
记录,请对值使用绝对 DNS 名称。绝对 DNS 名称以尾随句点.
结尾,例如foo.example.com.
。如果使用不带尾随句点的相对 DNS 名称,则该值将相对于CNAME
记录的区域。
示例
- name: Make sure some records exist and have the expected values
community.dns.hetzner_dns_record_sets:
zone: foo.com
records:
- prefix: new
type: A
ttl: 7200
value:
- 1.1.1.1
- 2.2.2.2
- prefix: new
type: AAAA
ttl: 7200
value:
- "::1"
- record: foo.com
type: TXT
value:
- test
hetzner_token: access_token
- name: Synchronize DNS zone with a fixed set of records
# If a record exists that is not mentioned here, it will be deleted
community.dns.hetzner_dns_record_sets:
zone_id: 23
purge: true
records:
- prefix: ''
type: A
value: 127.0.0.1
- prefix: ''
type: AAAA
value: "::1"
- prefix: ''
type: NS
value:
- ns-1.hoster.com
- ns-2.hoster.com
- ns-3.hoster.com
hetzner_token: access_token
返回值
常见返回值在此处记录 这里,以下是此模块特有的字段
键 |
描述 |
---|---|
区域的 ID。 已返回:成功 示例: |