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.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/plugins/lookup/inventory_hostnames.html