community.dns.reverse_lookup 查找 – 反向查找 IP 地址
注意
此查找插件是 community.dns 集合(版本 3.1.0)的一部分。
如果您正在使用 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.dns
。您需要其他要求才能使用此查找插件,有关详细信息,请参阅要求。
要在 playbook 中使用它,请指定:community.dns.reverse_lookup
。
community.dns 3.1.0 中的新增功能
概要
使用 DNS 反向查找查找 IP 地址的主机名。
要求
以下要求需要在执行此查找的本地控制器节点上满足。
dnspython >= 1.15.0(也许较旧的版本也可以工作)
术语
参数 |
注释 |
---|---|
要查找的 IP 地址。 |
关键字参数
这描述了查找的关键字参数。这些是以下示例中的值 key1=value1
、key2=value2
等:lookup('community.dns.reverse_lookup', key1=value1, key2=value2, ...)
和 query('community.dns.reverse_lookup', key1=value1, key2=value2, ...)
参数 |
注释 |
---|---|
DNS 查询超时的重试次数。 默认值: |
|
每次 DNS 查询的超时时间(以秒为单位)。 默认值: |
|
用于查找结果的 DNS 服务器。必须是一个或多个 IP 地址的列表。 默认情况下,使用系统的标准解析器。 |
|
在 SERVFAIL 错误时重试的频率。 默认值: |
注释
注意
当关键字参数和位置参数一起使用时,位置参数必须在关键字参数之前列出:
lookup('community.dns.reverse_lookup', term1, term2, key1=value1, key2=value2)
和query('community.dns.reverse_lookup', term1, term2, key1=value1, key2=value2)
请注意,当将此查找插件与
lookup()
一起使用时,如果结果是单元素列表,则 Ansible 仅返回该元素,而不是作为列表。由于这种行为令人惊讶并且可能导致问题,因此最好使用query()
而不是lookup()
。请参阅示例以及 Ansible 文档中的 强制查找返回列表。
示例
- name: Look up hostname of IPv4 address
ansible.builtin.debug:
msg: "{{ query('community.dns.reverse_lookup', '192.168.1.1') }}"
- name: Look up hostname of IPv6 address
ansible.builtin.debug:
msg: "{{ query('community.dns.reverse_lookup', '1:2:3::4') }}"
返回值
键 |
描述 |
---|---|