pagerduty - Create PagerDuty maintenance windows

Author:Justin Johns

Synopsis

New in version 1.2.

This module will let you create PagerDuty maintenance windows

Options

parameter	required	default	choices	comments
desc	no	Created by Ansible		Short description of maintenance window.
hours	no	1		Length of maintenance window in hours.
name	yes			PagerDuty unique subdomain.
passwd	yes			PagerDuty user password.
service	no			PagerDuty service ID.
state	yes		running started ongoing	Create a maintenance window or get a list of ongoing windows.
user	yes			PagerDuty user ID.
validate_certs	no	yes	yes no	If no, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. (added in Ansible 1.5.1)

Note

Requires PagerDuty API access

Examples

# List ongoing maintenance windows.
- pagerduty: name=companyabc user=example@example.com passwd=password123 state=ongoing

# Create a 1 hour maintenance window for service FOO123.
- pagerduty: name=companyabc
             user=example@example.com
             passwd=password123
             state=running
             service=FOO123

# Create a 4 hour maintenance window for service FOO123 with the description "deployment".
- pagerduty: name=companyabc
             user=example@example.com
             passwd=password123
             state=running
             service=FOO123
             hours=4
             desc=deployment

Note

This module does not yet have support to end maintenance windows.