ansible.builtin.varnames lookup – 查找匹配的变量名称

注意

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

Ansible 2.8 中新增

概要

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

术语

参数

注释

术语

字符串 / 必需

要在变量名称中搜索的 Python 正则表达式模式列表。

示例

- 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="{{ lookup('ansible.builtin.varnames', 'hosts')}}"

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

返回值

描述

返回值

列表 / 元素=字符串

请求的变量名称列表。

返回:成功

作者

  • Ansible 核心团队

提示

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