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

Новое в telekom_mms.icinga_director 1.25.0

Описание
Параметры
Примечания
Примеры

Описание

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

Параметры

Параметр	Комментарии
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а вместо этого добавлять определённые свойства. Примечание - Добавление к существующим переменным, импортам или любым другим спискам/словарям невозможно. Необходимо перезаписывать весь список/словарь. Примечание - Переменные, заданные по умолчанию, также будут применены, даже если не заданы. Варианты: `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 минут», можно написать 1ч 30м
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)://[пользователь[:пароль]]@хост.домен[:порт]/путь
url_password string	Пароль для использования в HTTP-аутентификации по принципу «имя пользователя/пароль». Если параметр `url_username` не указан, параметр `url_password` не будет использован.

url_username string	Имя пользователя для использования в аутентификации HTTP basic. Этот параметр может быть использован без `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–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_scheduled_downtime_module.html