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 boolean |
| Библиотека httplib2, используемая модулем uri, отправляет информацию об аутентификации только тогда, когда веб-сервис отвечает на начальный запрос статусом 401. Поскольку некоторые сервисы базовая аутентификация не отправляют должным образом статус 401, авторизация может не удаться. Этот параметр принудительно отправляет заголовок базовой аутентификации при первоначальном запросе. |
| ip - / обязательно | IP-адрес хоста. | |
| name - / обязательно | Имя, используемое для создания/удаления хоста. Не обязательно, чтобы это было полное доменное имя (FQDN), но оно должно быть уникальным. | |
| state - |
| Установить состояние функции. |
| template - | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. | |
| url - / обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password - | Пароль для использования в HTTP базовой аутентификации. Если параметр url_username не задан, параметр url_password не будет использован. | |
| url_username - | Имя пользователя для использования в HTTP базовой аутентификации. Этот параметр может использоваться без url_password для сайтов, допускающих пустые пароли. | |
| use_proxy boolean |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| validate_certs boolean |
| Если 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 словарь | всегда | Структура данных, используемая для создания, изменения или удаления хоста |
| name строка | всегда | Имя, используемое для создания, изменения или удаления хоста |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.9/modules/icinga2_host_module.html
