Модуль telekom_mms.icinga_director.icinga_endpoint — управление конечными точками в Icinga2

Примечание

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

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

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

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

Добавлено в telekom_mms.icinga_director 1.5.0

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

Добавление или удаление конечной точки в Icinga2 через API director.

Параметры

Параметр	Комментарии
api_timeout integer	Тайм-аут по умолчанию в секундах, в течение которого ожидается завершение транзакции. По умолчанию: `10`
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавить указанные свойства. Примечание. Добавить элементы к существующим vars, imports или любому другому списку/словарю невозможно. Необходимо перезаписать весь список/словарь. Примечание. Будут также применены переменные, заданные по умолчанию, даже если они не указаны. Варианты: `false` `true`
client_cert path	Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ. Если ключ включён в файл, параметр `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий закрытый ключ для аутентификации SSL-клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
force boolean	Если `yes`, не использовать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Передавать учётные данные, указанные в `url_username` и `url_password`, в заголовке HTTP. Варианты: `false` ← (по умолчанию) `true`
host string	Имя хоста/IP-адрес удалённого экземпляра Icinga 2.
http_agent string	Значение заголовка, идентифицирующего клиент; обычно отображается в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
log_duration string	Продолжительность хранения журналов повторного воспроизведения при потере соединения. По умолчанию — 1d (86400 секунд). Атрибут задаётся в секундах. Если для log_duration указать 0, повторное воспроизведение журналов будет отключено. Также можно указать значение в удобочитаемом формате, например 10m для 10 минут или 1h для одного часа.
object_name псевдонимы: name string / обязательный	Имя объекта Icinga для этой конечной точки. Обычно это полное доменное имя хоста, но, по сути, это может быть любая строка. Чтобы упростить работу пользователей, мы настоятельно рекомендуем использовать для шаблонов понятные имена. Например, «generic-endpoint» — неудачное имя, а «Стандартный сервер Linux» легче понять.
port integer	Имя службы/порт удалённого экземпляра Icinga 2. По умолчанию — 5665.
state string	Применить состояние функции. Варианты: `"present"` ← (по умолчанию) `"absent"`
url string / обязательный	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password string	Пароль для базовой аутентификации HTTP. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет.
url_username string	Имя пользователя для базовой аутентификации HTTP. Этот параметр можно использовать без `url_password` на сайтах, допускающих пустые пароли.
use_gssapi boolean добавлено в 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 boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Если `no`, SSL-сертификаты проверяться не будут. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
zone string	Имя зоны, к которой относится эта конечная точка.

Примечания

Примечание

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

Примеры

- name: Create an endpoint in icinga
  telekom_mms.icinga_director.icinga_endpoint:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "fooendpoint"
    host: "127.0.0.1"
    zone: "foozone"

- name: Update an endpoint in icinga
  telekom_mms.icinga_director.icinga_endpoint:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "fooendpoint"
    host: "127.0.0.1"
    zone: "foozone"
    port: 5665
    append: true

Авторы

Aaron Bulmahn (@arbu)

Ссылки на коллекцию

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