Модуль telekom_mms.icinga_director.icinga_timeperiod_info – Запрос временных периодов в Icinga2

Примечание

Этот модуль входит в коллекцию telekom_mms.icinga_director (версия 2.1.2).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install telekom_mms.icinga_director.

Чтобы использовать её в плейбуке, укажите: telekom_mms.icinga_director.icinga_timeperiod_info.

Новое в telekom_mms.icinga_director 1.13.0

Обзор
Параметры
Примечания
Примеры
Значения возврата

Обзор

Получить список объектов временных периодов из Icinga2 через API директора.

Параметры

Параметр	Комментарии
client_cert путь	Файл цепочки сертификатов в формате PEM, используемый для аутентификации SSL клиента. Этот файл также может содержать ключ, и если ключ включён, `client_key` не требуется.
client_key путь	Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации SSL клиента. Если `client_cert` содержит как сертификат, так и ключ, этот параметр не требуется.
force булево	Если `yes` не получать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth булево	Указанные с помощью `url_username` и `url_password` данные аутентификации должны передаваться в HTTP-заголовке. Варианты: `false` ← (по умолчанию) `true`
http_agent строка	Заголовок для идентификации, обычно отображается в логах веб-сервера. По умолчанию: `"ansible-httpget"`
query строка	Текст для фильтрации результатов поиска. Текст сопоставляется с object_name. В результатах будут возвращены только объекты, содержащие этот текст. Требуется Icinga Director 1.8.0+, в более ранних версиях этот параметр игнорируется, и возвращаются все объекты. По умолчанию: `""`
resolved булево	Разрешить все унаследованные свойства объектов и опустить шаблоны в выводе. Варианты: `false` ← (по умолчанию) `true`
url строка / обязательно	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь
url_password строка	Пароль для использования в HTTP-аутентификации. Если параметр `url_username` не указан, параметр `url_password` не будет использован.
url_username строка	Имя пользователя для использования в HTTP-аутентификации. Этот параметр может использоваться без `url_password` для сайтов, разрешающих пустые пароли.
use_gssapi булево добавлен в ansible-core 2.11	Использовать GSSAPI для выполнения аутентификации, обычно для Kerberos или Kerberos через механизм аутентификации Negotiate. Требуется установка Python библиотеки gssapi. Данные для GSSAPI могут быть указаны с `url_username`/`url_password` или с переменной окружения GSSAPI `KRB5CCNAME`, которая определяет пользовательский кэш аутентификации Kerberos. Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM установлен. Варианты: `false` ← (по умолчанию) `true`
use_proxy булево	Если `no`, не использовать прокси, даже если он определён в переменной среды на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
validate_certs булево	Если `no`, SSL-сертификаты не будут проверены. Это следует использовать только на контролируемых вами сайтах с самозаверенными сертификатами. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Этот модуль поддерживает режим проверки.

Примеры

- name: Query a timeperiod in icinga
  telekom_mms.icinga_director.icinga_timeperiod_info:
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    query: "24/7"

END_OF_DOCUMENT_MARKER

Значения возврата

Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:

Ключ	Описание
objects список / элементы=строка	Список возвращённых объектов Director. Список содержит все объекты, соответствующие фильтру запроса. Если фильтр не соответствует ни одному объекту, список будет пустым. Возвращается: всегда

Авторы

Martin Schurz (@schurzi)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/telekom_mms/icinga_director/icinga_timeperiod_info_module.html