t_systems_mms.icinga_director.icinga_servicegroup_info – Запрос групп служб в Icinga2
Примечание
Этот плагин входит в состав коллекции t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director.
Для использования в книге задач укажите: t_systems_mms.icinga_director.icinga_servicegroup_info.
Новое в версии 1.13.0: модуля t_systems_mms.icinga_director
Обзор
- Получение списка объектов группы служб из Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента по протоколу SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента по протоколу SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| force логический тип |
| Если yes не получать кэшированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.псевдонимы: thirsty |
| force_basic_auth логический тип |
| Указанные с помощью url_username и url_password учетные данные должны передаваться в заголовке HTTP. |
| http_agent строка | По умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно отображается в журналах веб-сервера. |
| query строка | По умолчанию: "" | Текст для фильтрации результатов поиска. Текст сопоставляется с object_name. В результате будут возвращены только объекты, содержащие этот текст. Требуется Icinga Director 1.8.0 и выше, в более ранних версиях этот параметр игнорируется и возвращаются все объекты. |
| resolved логический тип |
| Разрешение всех унаследованных свойств объекта и исключение шаблонов в выводе. |
| 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_gssapi логический тип добавлен в версии 2.11 ansible.builtin |
| Использование GSSAPI для выполнения аутентификации, обычно это для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка Python-библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или с помощью переменной среды GSSAPI KRB5CCNAME, которая указывает на пользовательский кэш учетных данных Kerberos.Аутентификация NTLM not поддерживается даже если механизм GSSAPI для NTLM установлен. |
| use_proxy логический тип |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| validate_certs логический тип |
| Если no, сертификаты SSL не будут проверены.Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Query a servicegroup in icinga
t_systems_mms.icinga_director.icinga_servicegroup_info:
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
query: "fooservicegroup"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| objects список / элементы=строка | всегда | Список возвращенных объектов директора. Список содержит все объекты, соответствующие фильтру запроса. Если фильтр не соответствует ни одному объекту, список будет пустым. |
Авторы
- Martin Schurz (@schurzi)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/t_systems_mms/icinga_director/icinga_servicegroup_info_module.html
