Skip to main content

cases

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

Overview

Namecases
TypeResource
Iddatadog.service_management.cases

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringCase's identifier (example: aeadc05e-98a8-11ec-ac2c-da7ad0900001)
attributesobjectCase resource attributes
relationshipsobjectResources related to a case
typestringCase resource type (default: case, example: case)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_caseselectcase_id, regionGet the details of case by case_id
create_caseinsertregion, data__dataCreate a Case
search_casesexecregionpage[size], page[number], sort[field], filter, sort[asc]Search cases.
archive_caseexeccase_id, region, dataArchive case
assign_caseexeccase_id, region, dataAssign case to a user
update_attributesexeccase_id, region, dataUpdate case attributes
update_priorityexeccase_id, region, dataUpdate case priority
update_statusexeccase_id, region, dataUpdate case status
unarchive_caseexeccase_id, region, dataUnarchive case
unassign_caseexeccase_id, region, dataUnassign case

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.

NameDatatypeDescription
case_idstringCase's UUID or key (example: f98a5a5b-e0ff-45d4-b2f5-afe6e74de504)
regionstring(default: datadoghq.com)
filterstringSearch query
page[number]integer (int64)Specific page number to return.
page[size]integer (int64)Size for a given page. The maximum allowed value is 100.
sort[asc]booleanSpecify if order is ascending or not
sort[field]stringSpecify which field to sort

SELECT examples

Get the details of case by case_id

SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.cases
WHERE case_id = '{{ case_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

Create a Case

INSERT INTO datadog.service_management.cases (
data__data,
region
)
SELECT
'{{ data }}' /* required */,
'{{ region }}'
RETURNING
data
;

Lifecycle Methods

Search cases.

EXEC datadog.service_management.cases.search_cases 
@region='{{ region }}' --required,
@page[size]='{{ page[size] }}',
@page[number]='{{ page[number] }}',
@sort[field]='{{ sort[field] }}',
@filter='{{ filter }}',
@sort[asc]={{ sort[asc] }}
;