community.general.dnstxt 查询 – 查询域名的 DNS txt 字段

注意

此查找插件是 community.general 集合（版本 10.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此查找插件，有关详细信息，请参阅要求。

要在剧本中使用它，请指定：community.general.dnstxt。

概要 

使用 python 库返回域名的 DNS TXT 记录。

要求 

以下要求需要在执行此查找的本地控制器节点上满足。

dns/dns.resolver（python 库）

术语 

参数	注释
术语列表 / 元素=字符串 / 必需	要从中查询 TXT 记录的域名或域名列表

关键字参数 

这描述了查找的关键字参数。这些是在以下示例中 key1=value1、key2=value2 等的值：lookup('community.general.dnstxt', key1=value1, key2=value2, ...) 和 query('community.general.dnstxt', key1=value1, key2=value2, ...)

参数	注释
real_empty 布尔值在 community.general 6.0.0 中添加	返回不带空字符串的空结果，并返回空列表而不是 `NXDOMAIN`。此选项的默认值将来可能会更改为 `true`。选项 `false` ← (默认) `true`

注释 

注意

当关键字参数和位置参数一起使用时，位置参数必须列在关键字参数之前：lookup('community.general.dnstxt', term1, term2, key1=value1, key2=value2) 和 query('community.general.dnstxt', term1, term2, key1=value1, key2=value2)

示例 

- name: show txt entry
  ansible.builtin.debug:
    msg: "{{lookup('community.general.dnstxt', ['test.example.com'])}}"

- name: iterate over txt entries
  ansible.builtin.debug:
    msg: "{{item}}"
  with_community.general.dnstxt:
    - 'test.example.com'
    - 'other.example.com'
    - 'last.example.com'

- name: iterate of a comma delimited DNS TXT entry
  ansible.builtin.debug:
    msg: "{{item}}"
  with_community.general.dnstxt: "{{lookup('community.general.dnstxt', ['test.example.com']).split(',')}}"

返回值 

键	描述
返回值列表 / 元素=字符串	DNS TXT 记录返回的值。返回: 成功

作者

Jan-Piet Mens (@jpmens) <jpmens(at)gmail.com>

提示

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