community.general.pagerduty – Создание окон технического обслуживания PagerDuty
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: 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 строка | ID пользователя, который инициирует запрос. Требуется только при создании maintenance_window. | |
| service список / элементы=строка | Список идентификаторов служб PagerDuty, разделенных запятыми. псевдонимы: services | |
| state строка / обязательно |
| Создать окно технического обслуживания или получить список текущих окон. |
| token строка / обязательно | Токен pagerduty, сгенерированный на сайте pagerduty. Используется для авторизации. | |
| user строка | ID пользователя PagerDuty. Устарело. Используйте token для авторизации. | |
| validate_certs логическое значение |
| Если no, сертификаты SSL не будут проверяться. Это следует использовать только на сайтах, контролируемых лично, с использованием самоподписанных сертификатов. |
| window_id строка | ID окна технического обслуживания. Требуется только при отсутствии maintenance_window. |
Примеры
- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/pagerduty_module.html