router_paths
Creates, updates, deletes, gets or lists a router_paths resource.
Overview
| Name | router_paths |
| Type | Resource |
| Id | pagerduty.event_orchestrations.router_paths |
Fields
The following fields are returned by SELECT queries:
- get
The Orchestration Router 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 | id | Get a Global Orchestration's Routing Rules.<br /><br />An Orchestration Router allows you to create a set of Event Rules. The Router evaluates Events you send to this Global Orchestration against each of its rules, one at a time, and routes the event to a specific Service based on the first rule that matches. If an event doesn't match any rules, it'll be sent to service specified in as the catch_all or the "Unrouted" Orchestration if no service is specified.<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: event_orchestrations.read<br /> | |
update | update | id, orchestration_path | Update a Global Orchestration's Routing Rules.<br /><br />An Orchestration Router allows you to create a set of Event Rules. The Router evaluates Events you send to this Global Orchestration against each of its rules, one at a time, and routes the event to a specific Service based on the first rule that matches. If an event doesn't match any rules, it'll be sent to service specified in as the catch_all or the "Unrouted" Orchestration if no service is specified.<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: event_orchestrations.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 an Event Orchestration. |
SELECT examples
- get
Get a Global Orchestration's Routing Rules.<br /><br />An Orchestration Router allows you to create a set of Event Rules. The Router evaluates Events you send to this Global Orchestration against each of its rules, one at a time, and routes the event to a specific Service based on the first rule that matches. If an event doesn't match any rules, it'll be sent to service specified in as the catch_all or the "Unrouted" Orchestration if no service is specified.<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: event_orchestrations.read<br />
SELECT
catch_all,
created_at,
created_by,
parent,
sets,
type,
updated_at,
updated_by,
version
FROM pagerduty.event_orchestrations.router_paths
WHERE id = '{{ id }}' -- required
;
UPDATE examples
- update
Update a Global Orchestration's Routing Rules.<br /><br />An Orchestration Router allows you to create a set of Event Rules. The Router evaluates Events you send to this Global Orchestration against each of its rules, one at a time, and routes the event to a specific Service based on the first rule that matches. If an event doesn't match any rules, it'll be sent to service specified in as the catch_all or the "Unrouted" Orchestration if no service is specified.<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: event_orchestrations.write<br />
UPDATE pagerduty.event_orchestrations.router_paths
SET
orchestration_path = '{{ orchestration_path }}'
WHERE
id = '{{ id }}' --required
AND orchestration_path = '{{ orchestration_path }}' --required
RETURNING
orchestration_path,
warnings;