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 | По умолчанию: "если значение не указано, используется значение параметра \u003cname\u003e" | Имя, используемое для отображения хоста. |
| force_basic_auth bool |
| httplib2, библиотека, используемая модулем uri, отправляет информацию об аутентификации только тогда, когда веб-сервис отвечает на начальный запрос статусом 401. Поскольку некоторые службы базовой аутентификации не отправляют должным образом 401, вход в систему может завершиться неудачей. Этот параметр принудительно отправляет заголовок базовой аутентификации при первоначальном запросе. |
| ip обязательно | IP-адрес хоста. | |
| name обязательно | Имя, используемое для создания/удаления хоста. Оно не обязательно должно быть полным доменным именем (FQDN), но должно быть уникальным. | |
| state |
| Состояние параметра. |
| template | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. | |
| url обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[user[:pass]]@host.domain[:port]/path | |
| url_password | Пароль для использования в HTTP-аутентификации по основанию. Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username | Имя пользователя для использования в HTTP-аутентификации по основанию. Этот параметр можно использовать без url_password для сайтов, которые допускают пустые пароли. | |
| use_proxy bool |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| validate_certs bool |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самозаверяющими сертификатами. |
| variables | Список переменных. | |
| zone | Зона, из которой следует получать данные об этом хосте. |
Примеры
- 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
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data dict | всегда | Структура данных, используемая для создания, изменения или удаления хоста |
| name строка | всегда | Имя, используемое для создания, изменения или удаления хоста |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/icinga2_host_module.html
