on_call_user_schedule
Creates, updates, deletes, gets or lists an on_call_user_schedule resource.
Overview
| Name | on_call_user_schedule |
| Type | Resource |
| Id | datadog.service_management.on_call_user_schedule |
Fields
The following fields are returned by SELECT queries:
- get_schedule_on_call_user
| Name | Datatype | Description |
|---|---|---|
id | string | The ShiftData id. |
attributes | object | Attributes for an on-call shift. |
relationships | object | Relationships for an on-call shift. |
type | string | Indicates that the resource is of type 'shifts'. (default: shifts, example: shifts) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_schedule_on_call_user | select | schedule_id, region | include, filter[at_ts] | Retrieves the user who is on-call for the specified schedule at a given time. |
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 |
|---|---|---|
region | string | (default: datadoghq.com) |
schedule_id | string | The ID of the schedule. |
filter[at_ts] | string | Retrieves the on-call user at the given timestamp (ISO-8601). Defaults to the current time if omitted." |
include | string | Specifies related resources to include in the response as a comma-separated list. Allowed value: user. |
SELECT examples
- get_schedule_on_call_user
Retrieves the user who is on-call for the specified schedule at a given time.
SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.on_call_user_schedule
WHERE schedule_id = '{{ schedule_id }}' -- required
AND region = '{{ region }}' -- required
AND include = '{{ include }}'
AND filter[at_ts] = '{{ filter[at_ts] }}'
;