community.dns.nameserver_info 模块 – 查询 DNS 名称的名称服务器

注意

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

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

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

要在 playbook 中使用它，请指定： community.dns.nameserver_info。

community.dns 2.6.0 中的新增功能

概要 

检索负责 DNS 名称的所有名称服务器。

需求 

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

dnspython >= 1.15.0（较旧的版本也可能有效）

参数 

参数	注释
always_ask_default_resolver 布尔值	设置为 `true`（默认值）时，将使用默认解析器查找子区域的权威名称服务器。有关如何配置默认解析器，请参见 `server`。设置为 `false` 时，将使用父区域的权威名称服务器查找子区域的权威名称服务器。只有在最近更改了名称服务器并且尚未传播时，此设置才有意义。选项 `false` `true` ← (默认值)
name 列表 / 元素=字符串 / 必需	要检索其名称服务器的 DNS 名称列表。
query_retry 整数	DNS 查询超时重试次数。默认值： `3`
query_timeout 浮点数	每次 DNS 查询的超时时间（秒）。默认值： `10.0`
resolve_addresses 布尔值	是否将名称服务器名称解析为 IP 地址。选项 `false` ← (默认值) `true`
server 列表 / 元素=字符串在 community.dns 2.7.0 中添加	用于查找结果的 DNS 服务器。必须是一个或多个 IP 地址的列表。默认情况下，使用系统的标准解析器。
servfail_retries 整数	在 SERVFAIL 错误上重试的次数。默认值： `0`

属性 

属性	支持	描述
check_mode	支持：完全支持此操作不会修改状态。	可以在 `check_mode` 中运行并返回更改状态预测，而无需修改目标。
diff_mode	支持： N/A 此操作不会修改状态。	处于差异模式时，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Retrieve name servers of two DNS names
  community.dns.nameserver_info:
    name:
      - www.example.com
      - example.org
  register: result

- name: Show nameservers for www.example.com
  ansible.builtin.debug:
    msg: '{{ result.results[0].nameserver }}'

返回值 

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

键	描述
results 列表 / 元素=字典	有关 `name` 中提供的每个 DNS 名称的名称服务器信息。返回：始终示例： `[{"name": "www.example.com", "nameservers": ["ns1.example.com", "ns2.example.com"]}, {"name": "example.org", "nameservers": ["ns1.example.org", "ns2.example.org", "ns3.example.org"]}]`
name 字符串	此条目所属的 DNS 名称。返回：始终示例： `"www.example.com"`
名称服务器列表 / 元素=字符串	此 DNS 名称的名称服务器列表。返回：成功示例： `["ns1.example.com", "ns2.example.com"]`

作者

Felix Fontein (@felixfontein)