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, логин может завершиться неудачей. Этот параметр принудительно отправляет заголовок Basic аутентификации при начальном запросе. |
| ip - / обязательно | IP-адрес хоста. | |
| name - / обязательно | Имя, используемое для создания/удаления хоста. Оно не обязательно должно быть полным доменным именем (FQDN), но должно быть уникальным. | |
| state - |
| Состояние применяемого функционала. |
| template - | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. | |
| url - / обязательно | URL в формате (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. [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.7/modules/icinga2_host_module.html
