inventory_hostnames - list of inventory hosts matching a host pattern¶

New in version 1.3.

Synopsis ¶

This lookup understands ‘host patterns’ as used bye the hosts: keyword in plays and can return a list of matching hosts from inventory

Note

this is only worth for ‘hostname patterns’ it is easier to loop over the group/group_names variables otherwise.

- name: show all the hosts matching the pattern, ie all but the group www
  debug:
    msg: "{{ item }}"
  with_inventory_hostnames:
    - all:!www

Common return values are documented here, the following are the fields unique to this lookup:

Key	Returned	Description
_hostnames list		list of hostnames that matched the host pattern in inventory

Hint

If you notice any issues in this documentation you can edit this document to improve it.