ansible.builtin.host_list – Parses a ‘host list’ string


This module is part of ansible-core and included in all Ansible installations. In most cases, you can use the short module name host_list even without specifying the collections: keyword. However, we recommend you use the FQCN for easy linking to the module documentation and to avoid conflicting with other collections that may have the same module name.

New in version 2.4: of ansible.builtin


  • Parses a host list string as a comma separated values of hosts

  • This plugin only applies to inventory strings that are not paths and contain a comma.


# define 2 hosts in command line
# ansible -i ',' -m ping all

# DNS resolvable names
# ansible -i ', host2' -m user -a 'name=me state=absent' all

# just use localhost
# ansible-playbook -i 'localhost,' play.yml -c local