Spec-Zone.ru › Ansible

telekom_mms.icinga_director.icinga_servicegroup_info модуль — Запрос servicegroup в Icinga2

Примечание

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

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

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

Для использования в playbook укажите: telekom_mms.icinga_director.icinga_servicegroup_info.

Новый в telekom_mms.icinga_director 1.13.0

  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Описание

  • Получить список объектов servicegroup из 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)://[user[:pass]]@host.domain[:port]/path

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 servicegroup in icinga
  telekom_mms.icinga_director.icinga_servicegroup_info:
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    query: "fooservicegroup"
END_OF_DOCUMENT_MARKER

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

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

Ключ

Описание

objects

список / элементы=строка

Список возвращённых объектов Director.

Список содержит все объекты, соответствующие фильтру запроса.

Если фильтр не соответствует ни одному объекту, список будет пустым.

Возвращается: всегда

Авторы

  • Мартин Шуц (@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_servicegroup_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API