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 }}