community.dns.hosttech_dns_zone_info 模块 – 在 Hosttech DNS 服务中检索区域信息

注意

此模块是 community.dns 集合 (版本 3.1.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.dns。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定：community.dns.hosttech_dns_zone_info。

community.dns 0.2.0 中的新增功能

摘要

  • 在 Hosttech DNS 服务中检索区域信息。

要求

执行此模块的主机需要以下要求。

  • lxml

参数

参数

注释

hosttech_password

字符串

Hosttech API 用户的密码。

如果提供，则还必须提供 hosttech_username。

与 hosttech_token 互斥。

hosttech_token

别名：api_token

字符串

在 community.dns 0.2.0 中添加

Hosttech API 用户的密码。

与 hosttech_username 和 hosttech_password 互斥。

自 community.dns 1.2.0 起，可以使用别名 api_token。

hosttech_username

字符串

Hosttech API 用户的用户名。

如果提供，则还必须提供 hosttech_password。

与 hosttech_token 互斥。

zone_id

整数

在 community.dns 0.2.0 中添加

要查询的 DNS 区域的 ID。

必须指定 zone_name 和 zone_id 中的一个。

zone_name

别名：zone

字符串

要查询的 DNS 区域。

必须指定 zone_name 和 zone_id 中的一个。

属性

属性

支持

描述

action_group

动作组： community.dns.hosttech

在 community.dns 2.4.0 中添加

在 module_defaults 中使用 group/community.dns.hosttech 为此模块设置默认值。

check_mode

支持：完全支持

此操作不会修改状态。

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持： N/A

此操作不会修改状态。

处于 diff 模式时，将返回有关已更改内容（或可能需要在 check_mode 中更改）的详细信息。

示例

- name: Retrieve details for foo.com zone
  community.dns.hosttech_dns_zone_info:
    zone_name: foo.com
    hosttech_username: foo
    hosttech_password: bar
  register: rec

- name: Retrieve details for zone 23
  community.dns.hosttech_dns_zone_info:
    zone_id: 23
    hosttech_token: access_token

返回值

常见的返回值已在 此处 记录，以下是此模块独有的字段

键

描述

zone_id

整数

区域的 ID。

返回：成功

示例：23

zone_info

字典

在 community.dns 2.0.0 中添加

API 返回的额外信息。

返回：成功

示例：{"dnssec": true, "dnssec_email": "test@example.com", "ds_records": [], "email": "test@example.com", "ttl": 3600}

dnssec

布尔值

DNSSEC 是否为此区域启用。

返回：已指定 hosttech_token 时。

dnssec_email

字符串

更改 DNSSEC 密钥时联系的电子邮件地址。

如果未启用 DNSSEC，则为 none。

返回：已指定 hosttech_token 时。

ds_records

列表 / 元素=字典

DS 记录。

详情请参见RFC 4034 的第 5 节和RFC 4034 的第 2.1 节。

如果未启用 DNSSEC，则为 none。

返回：已指定 hosttech_token 时。

算法

整数

此值为 DS 记录引用的 DNSKEY RR 的算法编号。

可以在RFC 4034 的附录 A.1中找到值的列表。

返回：成功

示例： 8

摘要

字符串

此 DS 记录引用的 DNSKEY RR 记录的摘要。

返回：成功

示例： "012356789ABCDEF0123456789ABCDEF012345678"

摘要类型

整数

此值标识用于构造摘要的算法。

可以在RFC 4034 的附录 A.2中找到值的列表。

返回：成功

示例： 1

标志

整数

区域密钥标志。详情请参见RFC 4034 的第 2.1.1 节。

返回：成功

示例： 257

密钥标签

整数

密钥标签字段列出了 DS 记录引用的 DNSKEY RR 的密钥标签。

返回：成功

示例： 12345

协议

整数

根据 RFC 4034，必须为 3。

返回：成功

示例： 3

公钥

字符串

公钥材料。

返回：成功

示例： "MuhdzsQdqEGShwjtJDKZZjdKqUSGluFzTTinpuEeIRzLLcgkwgAPKWFa eQntNlmcNDeCziGwpdvhJnvKXEMbFcZwsaDIJuWqERxAQNGABWfPlCLh HQPnbpRPNKipSdBaUhuOubvFvjBpFAwiwSAapRDVsAgKvjXucfXpFfYb pCundbAXBWhbpHVbqgmGoixXzFSwUsGVYLPpBCiDlLJwzjRKYYaoVYge kMtKFYUVnWIKbectWkDFdVqXwkKigCUDiuTTJxOBRJRNzGiDNMWBjYSm bBCAHMaMYaghLbYTwyKXltdHTHwBwtswGNfpnEdSpKFzZJonBZArQfHD lfceKgmKwEF="

电子邮件

字符串

SOA 记录中的区域 DNS 联系邮箱。

返回：成功

TTL

整数

区域的 TTL。

返回：成功

区域名称

整数

区域的名称。

返回：成功

示例： "example.com"

作者

  • Felix Fontein (@felixfontein)