Модуль telekom_mms.icinga_director.icinga_zone — управление зонами в 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_zone.

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

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

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

Добавление или удаление зоны в Icinga2 через API Director.

Параметры

Параметр	Комментарии
api_timeout integer	Тайм-аут по умолчанию в секундах ожидания завершения транзакции. По умолчанию: `10`
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять заданные свойства. Примечание. Невозможно добавить значения к существующим переменным, импортам или любым другим спискам/словарям. Необходимо перезаписать весь список/словарь. Примечание. Переменные, значения которых заданы по умолчанию, также будут применены, даже если они не указаны. Варианты: `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`
http_agent string	Значение заголовка для идентификации; обычно оно отображается в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
is_global boolean	Следует ли синхронизировать файлы конфигурации этой зоны со всеми конечными точками. Варианты: `false` ← (по умолчанию) `true`
object_name псевдонимы: name string / обязательный	Имя объекта Icinga для этой зоны. Обычно это полное доменное имя узла, но, по сути, это может быть строка любого вида. Чтобы упростить работу пользователей, мы настоятельно рекомендуем использовать осмысленные имена для шаблонов. Например, «generic-zone» — неудачное имя, а «Стандартный сервер Linux» понятнее.
parent string	Имя родительской зоны.
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` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create a zone in icinga
  telekom_mms.icinga_director.icinga_zone:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "foozone"

- name: Update a zone in icinga
  telekom_mms.icinga_director.icinga_zone:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "foozone"
    parent: "master"
    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_zone_module.html