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. Поскольку некоторые сервисы аутентификации по протоколу Basic не правильно отправляют 401, вход может не удастся. Этот параметр принудительно отправляет заголовок Basic authentication при первоначальном запросе. |
| ip - / обязательно | IP-адрес хоста. | |
| name - / обязательно | Имя, используемое для создания/удаления хоста. Это не обязательно должно быть FQDN, но должно быть уникальным. | |
| state - |
| Применение состояния функции. |
| template - | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. | |
| url - / обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password - | Пароль для аутентификации по протоколу HTTP Basic. Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username - | Имя пользователя для аутентификации по протоколу HTTP Basic. Этот параметр можно использовать без 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. [community]
Авторы
- 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.8/modules/icinga2_host_module.html
