ansible.builtin.varnames 查询 – 查询匹配的变量名称

注意

此查询插件是ansible-core的一部分，包含在所有Ansible安装中。在大多数情况下，您可以使用简短的插件名称varnames。但是，我们建议您使用完全限定集合名称 (FQCN) ansible.builtin.varnames，以便轻松链接到插件文档并避免与可能具有相同查询插件名称的其他集合冲突。

Ansible 2.8中的新功能

概要 

检索匹配的Ansible变量名称列表。

术语 

参数	注释
术语字符串 / 必需	要在变量名称中搜索的Python正则表达式模式列表。

另请参阅 

另请参阅

ansible.builtin.vars 查询插件: 查询变量的模板化值。

示例 

- name: List variables that start with qz_
  ansible.builtin.debug: msg="{{ lookup('ansible.builtin.varnames', '^qz_.+') }}"
  vars:
    qz_1: hello
    qz_2: world
    qa_1: "I won't show"
    qz_: "I won't show either"

- name: Show all variables
  ansible.builtin.debug: msg="{{ lookup('ansible.builtin.varnames', '.+') }}"

- name: Show variables with 'hosts' in their names
  ansible.builtin.debug: msg="{{ q('varnames', 'hosts') }}"

- name: Find several related variables that end specific way
  ansible.builtin.debug: msg="{{ query('ansible.builtin.varnames', '.+_zone$', '.+_location$') }}"

- name: display values from variables found via varnames (note "*" is used to dereference the list to a 'list of arguments')
  debug: msg="{{ lookup('vars', *lookup('varnames', 'ansible_play_.+')) }}"

返回值 

键	描述
返回值列表 / 元素=字符串	请求的变量名称列表。返回：成功

作者

Ansible核心团队

提示

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