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=value1key2=value2 等:lookup('community.dns.reverse_lookup', key1=value1, key2=value2, ...)query('community.dns.reverse_lookup', key1=value1, key2=value2, ...)

参数

注释

query_retry

整数

DNS 查询超时的重试次数。

默认值: 3

query_timeout

浮点数

每次 DNS 查询的超时时间(以秒为单位)。

默认值: 10.0

server

列表 / 元素=字符串

用于查找结果的 DNS 服务器。必须是一个或多个 IP 地址的列表。

默认情况下,使用系统的标准解析器。

servfail_retries

整数

在 SERVFAIL 错误时重试的频率。

默认值: 0

注释

注意

  • 当关键字参数和位置参数一起使用时,位置参数必须在关键字参数之前列出: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') }}"

返回值

描述

返回值

列表 / 元素=字符串

为查询的 IP 地址返回的主机名。

如果在 _terms 中查询了多个 IP 地址,则会将生成的列表连接在一起。

已返回: 成功

示例: ["example.com", "example.org"]

作者

  • Felix Fontein (@felixfontein)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如,列表中较低的变量将覆盖列表中较高的变量。