Модуль telekom_mms.icinga_director.icinga_scheduled_downtime — управление простоями в 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_scheduled_downtime.

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

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

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

Добавление или удаление простоя в Icinga2 через API Director.

Параметры

Параметр	Описание
api_timeout integer	Время ожидания завершения транзакции по умолчанию, в секундах. По умолчанию: `10`
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять заданные свойства. Примечание. Нельзя добавлять значения к существующим vars, imports или другим спискам/словарям. Необходимо перезаписать весь список/словарь. Примечание. Также будут применены переменные, заданные по умолчанию, даже если они не указаны. Варианты: `false` `true`
apply_to string	Должна ли эта зависимость распространяться на узлы или службы Обязательный параметр, если state имеет значение `present`. Варианты: `"host"` `"service"`
assign_filter string	Фильтр, определяющий, на что будет распространяться простой.
author string	Имя автора простоя. Обязательный параметр, если state имеет значение `present`.
client_cert path	Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ; если ключ в него включён, параметр `client_key` не требуется.
client_key path	Файл в формате PEM с закрытым ключом для аутентификации SSL-клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
comment string	Описание простоя. Обязательный параметр, если state имеет значение `present`.
disabled boolean	Отключённые объекты не будут развёрнуты. Варианты: `false` ← (по умолчанию) `true`
duration string	Продолжительность простоя. Применяется только к гибким (нефиксированным) простоям. Время указывается в секундах; поддерживаются суффиксы ms (миллисекунды), s (секунды), m (минуты), h (часы) и d (дни). Чтобы указать «90 минут», можно написать 1h 30m
fixed boolean	Является ли простой фиксированным или гибким. Если вы не уверены, обратитесь к соответствующей документации https://icinga.com/docs/icinga2/latest/doc/08-advanced-topics/#downtimes Обязательный параметр, если state имеет значение `present`. Варианты: `false` ← (по умолчанию) `true`
force boolean	Если `yes`, не получать копию из кэша. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Передавать учётные данные, указанные с помощью `url_username` и `url_password`, в заголовке HTTP. Варианты: `false` ← (по умолчанию) `true`
http_agent string	Значение заголовка идентификации; обычно отображается в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
object_name псевдонимы: name string / обязательный	Имя объекта Icinga для этого простоя.
ranges dictionary	Период, на который назначается простой По умолчанию: `{}`
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` ← (по умолчанию)
with_services boolean	Назначать простой только узлам или также включить в него службы. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: create icinga_scheduled_downtime
  telekom_mms.icinga_director.icinga_scheduled_downtime:
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    disabled: false
    object_name: "foodowntime"
    state: present
    author: testuser
    comment: test
    fixed: true
    with_services: true
    apply_to: host
    assign_filter: 'host.name="foohost"'
    duration: 500
    ranges:
      "tuesday": "00:00-24:00"

- name: create icinga_scheduled_downtime2
  telekom_mms.icinga_director.icinga_scheduled_downtime:
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    disabled: false
    object_name: "foodowntime2"
    state: present
    author: testuser
    comment: test
    fixed: false
    with_services: false
    apply_to: host
    assign_filter: 'host.name="foohost"'
    duration: 500
    ranges:
      "tuesday": "00:00-24:00"

- name: update icinga_scheduled_downtime2
  telekom_mms.icinga_director.icinga_scheduled_downtime:
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "foodowntime2"
    state: present
    duration: 1000
    append: true
    apply_to: host
    with_services: false

Авторы

Daniel Uhlmann (@xFuture603)

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

© 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_scheduled_downtime_module.html