service_paths
Creates, updates, deletes, gets or lists a service_paths resource.
Overview
| Name | service_paths |
| Type | Resource |
| Id | pagerduty.event_orchestrations.service_paths |
Fields
The following fields are returned by SELECT queries:
- get
The Service Orchestration object.
| Name | Datatype | Description |
|---|---|---|
catch_all | object | When none of the Rules in a set match an event, we apply the catch_all actions to the event. |
created_at | string (date-time) | The date/time the object was created. |
created_by | object | Reference to the user that created the object. |
parent | object | |
sets | array | Must contain at least a "start" set, but can contain any number of additional sets that are routed to by other rules to form a directional graph of rules. |
type | string | (default: service) |
updated_at | string (date-time) | The date/time the object was last updated. |
updated_by | object | Reference to the user that last updated the object. |
version | string | Version of these Orchestration Rules |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | service_id | include[] | Get a Service Orchestration.<br /><br />A Service Orchestration allows you to create a set of Event Rules. The Service Orchestration evaluates Events sent to this Service against each of its rules, beginning with the rules in the "start" set. When a matching rule is found, it can modify and enhance the event and can route the event to another set of rules within this Service Orchestration for further processing.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#event-orchestrations)<br /><br />Scoped OAuth requires: services.read<br /> |
update | update | service_id, orchestration_path | Update a Service Orchestration.<br /><br />A Service Orchestration allows you to create a set of Event Rules. The Service Orchestration evaluates Events sent to this Service against each of its rules, beginning with the rules in the "start" set. When a matching rule is found, it can modify and enhance the event and can route the event to another set of rules within this Service Orchestration for further processing.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#event-orchestrations)<br /><br />Scoped OAuth requires: services.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 |
|---|---|---|
service_id | string | The service ID |
include[] | string | Array of additional Models to include in response. |
SELECT examples
- get
Get a Service Orchestration.<br /><br />A Service Orchestration allows you to create a set of Event Rules. The Service Orchestration evaluates Events sent to this Service against each of its rules, beginning with the rules in the "start" set. When a matching rule is found, it can modify and enhance the event and can route the event to another set of rules within this Service Orchestration for further processing.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#event-orchestrations)<br /><br />Scoped OAuth requires: services.read<br />
SELECT
catch_all,
created_at,
created_by,
parent,
sets,
type,
updated_at,
updated_by,
version
FROM pagerduty.event_orchestrations.service_paths
WHERE service_id = '{{ service_id }}' -- required
AND include[] = '{{ include[] }}'
;
UPDATE examples
- update
Update a Service Orchestration.<br /><br />A Service Orchestration allows you to create a set of Event Rules. The Service Orchestration evaluates Events sent to this Service against each of its rules, beginning with the rules in the "start" set. When a matching rule is found, it can modify and enhance the event and can route the event to another set of rules within this Service Orchestration for further processing.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#event-orchestrations)<br /><br />Scoped OAuth requires: services.write<br />
UPDATE pagerduty.event_orchestrations.service_paths
SET
orchestration_path = '{{ orchestration_path }}'
WHERE
service_id = '{{ service_id }}' --required
AND orchestration_path = '{{ orchestration_path }}' --required
RETURNING
orchestration_path,
warnings;