Skip to main content

case_links

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

Overview

Namecase_links
TypeResource
Iddatadog.service_management.case_links

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe case link identifier. (example: 804cd682-55f6-4541-ab00-b608b282ea7d)
attributesobjectAttributes describing a directional relationship between two entities (cases, incidents, or pages).
typestringJSON:API resource type for case links. (link) (example: link)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_case_linksselectentity_type, entity_idrelationshipReturns all links associated with a case. Links define relationships (for example, BLOCKS) between cases. Requires entity_type and entity_id query parameters.

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
entity_idstringThe UUID of the entity to look up links for.
entity_typestringThe entity type to look up links for. Use CASE to find links for a specific case.
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
relationshipstringOptional filter to only return links of a specific relationship type (for example, BLOCKS or CAUSES).

SELECT examples

Returns all links associated with a case. Links define relationships (for example, BLOCKS) between cases. Requires entity_type and entity_id query parameters.

SELECT
id,
attributes,
type
FROM datadog.service_management.case_links
WHERE entity_type = '{{ entity_type }}' -- required
AND entity_id = '{{ entity_id }}' -- required
AND relationship = '{{ relationship }}'
;