New in version 2.3.
Name of host-group.
Can not be changed as it is the unique identifier.
List of hosts that belong to the host-group.
If an empty list is passed all hosts will be removed from the group.
If option is omitted hosts will not be checked or changed.
If option is passed all assigned hosts that are not passed will be unassigned from the group.
List of host-groups than belong to that host-group.
If an empty list is passed all host-groups will be removed from the group.
If option is omitted host-groups will not be checked or changed.
If option is passed all assigned hostgroups that are not passed will be unassigned from the group.
IP or hostname of IPA server
Password of administrative user
Port of IPA server
Protocol used by IPA server
Administrative account used on IPA server
State to ensure.
This only applies if
If set to
This should only set to
# Ensure host-group databases is present - ipa_hostgroup: name: databases state: present host: - db.example.com hostgroup: - mysql-server - oracle-server ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret # Ensure host-group databases is absent - ipa_hostgroup: name: databases state: absent ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret
Common return values are documented here Return Values, the following are the fields unique to this module:
|hostgroup||Hostgroup as returned by IPA API.||always||dict|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support