community.general.pagerduty – Создание временных периодов технического обслуживания в PagerDuty

Примечание

Этот плагин является частью коллекции community.general (версия 2.0.1).

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

Для использования в книге задач укажите: community.general.pagerduty

Обзор
Требования
Параметры
Примеры

Обзор

Этот модуль позволит вам создавать временные периоды технического обслуживания в PagerDuty

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

Доступ к API PagerDuty

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
desc строка	Значение по умолчанию: "Создано Ansible"	Краткое описание временного периода технического обслуживания.
hours строка	Значение по умолчанию: "1"	Продолжительность временного периода технического обслуживания в часах.
minutes строка	Значение по умолчанию: "0"	Продолжительность временного периода технического обслуживания в минутах (добавляется к часам).
name строка		Уникальный домен PagerDuty. Устарело. Не используется с API PagerDuty REST v2.
requester_id строка		Идентификатор пользователя, запрашивающего действие. Требуется только при создании временного периода технического обслуживания.
service список / элементы=строка		Список идентификаторов служб PagerDuty, разделенных запятыми. Псевдонимы: services
state строка / обязательно	Варианты: running started ongoing absent	Создать временной период технического обслуживания или получить список текущих периодов.
token строка / обязательно		Токен PagerDuty, сгенерированный на сайте PagerDuty. Используется для авторизации.
user строка		Идентификатор пользователя PagerDuty. Устарело. Используйте token для авторизации.
validate_certs логическое	Варианты: no да ←	Если `no`, сертификаты SSL не будут валидироваться. Это следует использовать только на контролируемых вами сайтах с самозаверенными сертификатами.
window_id строка		Идентификатор временного периода технического обслуживания. Требуется только при отсутствии временного периода технического обслуживания.

Примеры

- name: List ongoing maintenance windows using a token
  community.general.pagerduty:
    name: companyabc
    token: xxxxxxxxxxxxxx
    state: ongoing

- name: Create a 1 hour maintenance window for service FOO123
  community.general.pagerduty:
    name: companyabc
    user: example@example.com
    token: yourtoken
    state: running
    service: FOO123

- name: Create a 5 minute maintenance window for service FOO123
  community.general.pagerduty:
    name: companyabc
    token: xxxxxxxxxxxxxx
    hours: 0
    minutes: 5
    state: running
    service: FOO123


- name: Create a 4 hour maintenance window for service FOO123 with the description "deployment"
  community.general.pagerduty:
    name: companyabc
    user: example@example.com
    state: running
    service: FOO123
    hours: 4
    desc: deployment
  register: pd_window

- name: Delete the previous maintenance window
  community.general.pagerduty:
    name: companyabc
    user: example@example.com
    state: absent
    window_id: '{{ pd_window.result.maintenance_window.id }}'

# Delete a maintenance window from a separate playbook than its creation,
# and if it is the only existing maintenance window
- name: Check
  community.general.pagerduty:
    requester_id: XXXXXXX
    token: yourtoken
    state: ongoing
  register: pd_window

- name: Delete
  community.general.pagerduty:
    requester_id: XXXXXXX
    token: yourtoken
    state: absent
    window_id: "{{ pd_window.result.maintenance_windows[0].id }}"

Авторы

Andrew Newdigate (@suprememoocow)
Dylan Silva (@thaumos)
Justin Johns (!UNKNOWN)
Bruce Pennypacker (@bpennypacker)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/pagerduty_module.html