icinga2_host — Управление хостом в Icinga2
Новая в версии 2.5.
Обзор
- Добавление или удаление хоста в Icinga2 через API.
- См. https://www.icinga.com/docs/icinga2/latest/doc/12-icinga2-api/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| check_command | Значение по умолчанию: hostalive | Команда, используемая для проверки активности хоста. |
| client_cert | Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации клиента SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| display_name | Значение по умолчанию: если не указано, используется значение параметра <name> | Имя, используемое для отображения хоста. |
| force_basic_auth |
| Библиотека httplib2, используемая модулем uri, отправляет информацию об аутентификации только тогда, когда веб-сервис отвечает на начальный запрос статусом 401. Поскольку некоторые сервисы аутентификации по схеме basic не правильно отправляют 401, попытки входа могут завершиться неудачей. Этот параметр принудительно отправляет заголовок Basic аутентификации при первом запросе. |
| ip обязательно | IP-адрес хоста. | |
| name обязательно | Имя, используемое для создания/удаления хоста. Оно не обязательно должно быть полным доменным именем (FQDN), но должно быть уникальным. | |
| state |
| Применяет состояние функции. |
| template | Значение по умолчанию: None | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. |
| url обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password | Пароль для использования в аутентификации HTTP по схеме basic. Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username | Имя пользователя для использования в аутентификации HTTP по схеме basic. Этот параметр может быть использован без url_password для сайтов, допускающих пустые пароли. | |
| use_proxy |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| validate_certs |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах под вашим контролем, использующих самозаверяемые сертификаты. |
| variables | Значение по умолчанию: None | Список переменных. |
| zone | Зона, из которой должен собираться информация об этом хосте. |
Примеры
- name: Add host to icinga
icinga_host:
url: "https://icinga2.example.co,m"
url_username: "ansible"
url_password: "a_secret"
state: present
name: "{{ ansible_fqdn }}"
ip: "{{ ansible_default_ipv4.address }}"
delegate_to: 127.0.0.1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data dict | всегда | Структура данных, используемая для создания, изменения или удаления хоста |
| name строка | всегда | Имя, используемое для создания, изменения или удаления хоста |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантированно будет совместим со старыми версиями.
Автор
- Jurgen Brand (@t794104)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/modules/icinga2_host_module.html
