icinga2_host – Manage a host in Icinga2¶
New in version 2.5.
Synopsis¶
- Add or remove a host to Icinga2 through the API.
- See https://www.icinga.com/docs/icinga2/latest/doc/12-icinga2-api/
Parameters¶
Examples¶
- name: Add host to icinga
icinga2_host:
url: "https://icinga2.example.com"
url_username: "ansible"
url_password: "a_secret"
state: present
name: "{{ ansible_fqdn }}"
ip: "{{ ansible_default_ipv4.address }}"
delegate_to: 127.0.0.1
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
data
dictionary
|
always |
The data structure used for create, modify or delete of the host
|
name
string
|
always |
The name used to create, modify or delete the host
|
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Jurgen Brand (@t794104)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.