ansible.builtin.inventory_hostnames lookup – 匹配主机模式的清单主机列表

注意

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

概要

  • 此lookup理解剧本中hosts:关键字使用的“主机模式”，并可以返回清单中匹配主机的列表。

备注

注意

  • 这仅适用于“主机名模式”，否则迭代group/group_names变量更容易。

示例

- name: show all the hosts matching the pattern, i.e. all but the group www
  ansible.builtin.debug:
    msg: "{{ item }}"
  with_inventory_hostnames:
    - all:!www

返回值

键

描述

返回值

列表 / 元素=字符串

与清单中主机模式匹配的主机名列表

返回：成功

作者

  • Michael DeHaan

  • Steven Dossett

提示

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