community.dns.lookup lookup – 查找 DNS 记录
注意
此查找插件是 community.dns 集合（版本 3.1.0）的一部分。
如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install community.dns。您需要其他要求才能使用此查找插件，有关详细信息，请参阅要求。
要在 playbook 中使用它，请指定：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' ) }}"
返回值
键 |
描述 |
|---|---|