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 核心团队

提示

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