status_update_notification_rules

Creates, updates, deletes, gets or lists a status_update_notification_rules resource.

Overview

Name	status_update_notification_rules
Type	Resource
Id	pagerduty.users.status_update_notification_rules

Fields

The following fields are returned by SELECT queries:

get

The user's status update notification rule requested.

Name	Datatype	Description
contact_method	object	(opaque JSON object)

list

A list of status update notification rules.

Name	Datatype	Description
contact_method	object	(opaque JSON object)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	id, status_update_notification_rule_id	include[]	Get details about a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.read<br />
list	select	id	include[]	List status update notification rules of your PagerDuty user.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.read<br />
create	insert	id, status_update_notification_rule		Create a new status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />
update	update	id, status_update_notification_rule_id, status_update_notification_rule		Update a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />
delete	delete	id, status_update_notification_rule_id		Remove a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id	string	The ID of the resource.
status_update_notification_rule_id	string	The status update notification rule ID on the user.
include[]	string	Array of additional details to include.

SELECT examples

get

Get details about a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.read<br />

SELECT
contact_method
FROM pagerduty.users.status_update_notification_rules
WHERE id = '{{ id }}' -- required
AND status_update_notification_rule_id = '{{ status_update_notification_rule_id }}' -- required
AND include[] = '{{ include[] }}'
;

list

List status update notification rules of your PagerDuty user.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.read<br />

SELECT
contact_method
FROM pagerduty.users.status_update_notification_rules
WHERE id = '{{ id }}' -- required
AND include[] = '{{ include[] }}'
;

INSERT examples

create

Create a new status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />

INSERT INTO pagerduty.users.status_update_notification_rules (
status_update_notification_rule,
id
)
SELECT 
'{{ status_update_notification_rule }}' /* required */,
'{{ id }}'
RETURNING
status_update_notification_rule
;

Manifest

# Description fields are for documentation purposes
- name: status_update_notification_rules
props:
  - name: id
    value: "{{ id }}"
    description: Required parameter for the status_update_notification_rules resource.
  - name: status_update_notification_rule
    description: |
      A rule for contacting the user for Incident Status Updates.
    value:
      contact_method:
        id: "{{ id }}"
        summary: "{{ summary }}"
        type: "{{ type }}"
        self: "{{ self }}"
        html_url: "{{ html_url }}"

UPDATE examples

update

Update a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />

UPDATE pagerduty.users.status_update_notification_rules
SET 
status_update_notification_rule = '{{ status_update_notification_rule }}'
WHERE 
id = '{{ id }}' --required
AND status_update_notification_rule_id = '{{ status_update_notification_rule_id }}' --required
AND status_update_notification_rule = '{{ status_update_notification_rule }}' --required
RETURNING
notification_rule;

DELETE examples

delete

Remove a user's status update notification rule.<br /><br />Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#users)<br /><br />Scoped OAuth requires: users.write<br />

DELETE FROM pagerduty.users.status_update_notification_rules
WHERE id = '{{ id }}' --required
AND status_update_notification_rule_id = '{{ status_update_notification_rule_id }}' --required
;