community.dns.hosttech_dns_records 清单 - 从 Hosttech DNS 记录创建清单
注意
此清单插件是 community.dns 集合(版本 3.1.0)的一部分。
如果您使用的是 ansible
包,您可能已经安装了此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.dns
。您需要进一步的要求才能使用此清单插件,请参阅 要求 获取详细信息。
要在 playbook 中使用它,请指定:community.dns.hosttech_dns_records
。
community.dns 2.0.0 中的新功能
概要
为了使 Ansible 能够将 YAML 文件识别为此插件的清单,清单文件必须包含
plugin: community.dns.hosttech_dns_records
,并且其文件名必须以hosttech_dns.yaml
或hosttech_dns.yml
结尾记录按前缀/记录名称和值匹配。
此插件允许从 Hosttech DNS 记录创建清单。
要求
在执行此清单的本地控制器节点上需要以下要求。
lxml
参数
参数 |
注释 |
---|---|
允许为此清单选择/取消选择主机的包含/排除过滤器列表。 过滤器按顺序处理,直到找到第一个匹配 |
|
Jinja2 条件。如果它匹配主机,则该主机将被 排除 。 只能指定 |
|
Jinja2 条件。如果它匹配主机,则该主机将被 包含 。 只能指定 |
|
Hosttech API 用户的密码。 如果提供,则还必须提供 与 配置
|
|
Hosttech API 用户的密码。 与 自 community.dns 1.2.0 起,可以使用别名 配置
|
|
Hosttech API 用户的用户名。 如果提供此选项,则还必须提供 与 配置
|
|
此插件的名称。对于此插件,应始终设置为 选项
|
|
筛选器值对的字典。 此选项在 community.dns 3.0.0 之前名为 默认值: |
|
要使用的记录类型的值。 选项
默认值: |
|
是否将数字转义序列 ( 默认值在 community.dns 3.0.0 中更改为 选项
|
|
确定如何在 API 和此模块的输入和输出之间转换 TXT 条目值。 值 值 值 默认值 注意:转换代码假定值为 UTF-8 编码。如果您需要其他编码,请使用 选项
|
|
备注
注意
特定于提供程序的
hosttech_username
、hosttech_password
和hosttech_token
选项可以进行模板化。
另请参阅
另请参阅
- community.dns.hosttech_dns_record_set_info
检索 Hosttech DNS 服务中的记录集。
- community.dns.hosttech_dns_record_info
检索 Hosttech DNS 服务中的记录。
示例
# filename must end with hosttech_dns.yaml or hosttech_dns.yml
plugin: community.dns.hosttech_dns_records
zone_name: domain.ch
simple_filters:
type:
- AAAA
filters:
- include: >-
'*.' not in inventory_hostname
- exclude: true
# You can also configure the token by putting secret value into this file,
# but this is discouraged. Use a lookup like below, or leave it away and
# set it with the ANSIBLE_HOSTTECH_DNS_TOKEN environment variable.
hosttech_token: >-
{{ (lookup('community.sops.sops', 'keys/hosttech.sops.yml') | from_yaml).hosttech_dns_token }}