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。您需要进一步的要求才能使用此模块，请参阅 要求 以了解详细信息。

要在 playbook 中使用它，请指定：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

支持: 不适用

此操作不会修改状态。

当处于 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

返回值

通用返回值已在此处记录：这里，以下是此模块特有的字段

Key

描述

zone_id

整数

区域的 ID。

返回: 成功

示例: 23

zone_info

字典

在 community.dns 2.0.0 中添加

API 返回的额外信息。

返回: 成功

示例: {"dnssec": true, "dnssec_email": "[email protected]", "ds_records": [], "email": "[email protected]", "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 时。

algorithm

整数

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

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

返回: 成功

示例: 8

digest

字符串

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

返回: 成功

示例: "012356789ABCDEF0123456789ABCDEF012345678"

digest_type

整数

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

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

返回: 成功

示例: 1

flags

整数

区域密钥标志。有关详细信息，请参阅 RFC 4034 的第 2.1.1 节。

返回: 成功

示例: 257

key_tag

整数

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

返回: 成功

示例: 12345

protocol

整数

根据 RFC 4034，必须为 3。

返回: 成功

示例: 3

public_key

字符串

公钥材料。

返回: 成功

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

email

字符串

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

返回: 成功

ttl

整数

区域的 TTL。

返回: 成功

zone_name

整数

区域的名称。

返回: 成功

示例: "example.com"

作者

  • Felix Fontein (@felixfontein)