community.dns.lookup 查询 – 查找 DNS 记录
注意
此查找插件是 community.dns 集合（版本 3.1.0）的一部分。
如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install community.dns。您需要进一步的要求才能使用此查找插件，有关详细信息，请参阅要求。
要在剧本中使用它，请指定：community.dns.lookup。
community.dns 2.6.0 中的新功能
概要
查找 DNS 记录。
要求
本地控制节点需要满足以下要求才能执行此查找。
dnspython >= 1.15.0 (可能较旧的版本也有效)
ipaddress（在 Python 2.7 上使用
server时）
术语
参数 |
注释 |
|---|---|
要查询的域名。 |
关键字参数
这描述了查找的关键字参数。这些是以下示例中的值 key1=value1、key2=value2 等：lookup('community.dns.lookup', key1=value1, key2=value2, ...) 和 query('community.dns.lookup', key1=value1, key2=value2, ...)
参数 |
注释 |
|---|---|
DNS 查询超时的重试次数。 默认值: |
|
每次 DNS 查询的超时时间（以秒为单位）。 默认值: |
|
如果 如果 请注意，此行为在 community.dns 3.0.0 中发生了更改。在 community.dns 2.x.y 中， 选项
|
|
用于查找结果的 DNS 服务器。必须是一个或多个 IP 地址的列表。 默认情况下，使用系统的标准解析器。 |
|
在 SERVFAIL 错误时重试的频率。 默认值: |
|
要检索的记录类型。 选项
|
备注
注意
当关键字和位置参数一起使用时，位置参数必须在关键字参数之前列出：
lookup('community.dns.lookup', term1, term2, key1=value1, key2=value2)和query('community.dns.lookup', term1, term2, key1=value1, key2=value2)请注意，当使用此查找插件与
lookup()时，如果结果是一个单元素列表，Ansible 只会返回该元素而不是列表。 由于此行为令人惊讶且可能导致问题，因此最好使用query()而不是lookup()。 请参阅示例以及 Ansible 文档中的 强制查找返回列表。
示例
- name: Look up A (IPv4) records for example.org
ansible.builtin.debug:
msg: "{{ query('community.dns.lookup', 'example.org.') }}"
- name: Look up AAAA (IPv6) records for example.org
ansible.builtin.debug:
msg: "{{ query('community.dns.lookup', 'example.org.', type='AAAA' ) }}"
返回值
键 |
描述 |
|---|---|