incident_global_incident_handles

Creates, updates, deletes, gets or lists an incident_global_incident_handles resource.

Overview

Name	incident_global_incident_handles
Type	Resource
Id	datadog.service_management.incident_global_incident_handles

Fields

The following fields are returned by SELECT queries:

list_global_incident_handles

Name	Datatype	Description
id	string	The ID of the incident handle (example: 12ceee6d-a7c0-4407-bc54-30e54140d7f0)
attributes	object	Incident handle attributes for responses
relationships	object	Relationships associated with an incident handle response, including linked users and incident type.
type	string	Incident handle resource type (incidents_handles) (example: incidents_handles)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_global_incident_handles	select		include	Retrieve a list of global incident handles.
create_global_incident_handle	insert	data	include	Create a new global incident handle.
update_global_incident_handle	replace	data	include	Update an existing global incident handle.
delete_global_incident_handle	delete			Delete a global incident handle.

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
site	string	The 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.
include	string	Comma-separated list of related resources to include in the response

SELECT examples

list_global_incident_handles

Retrieve a list of global incident handles.

SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.incident_global_incident_handles
WHERE include = '{{ include }}'
;

INSERT examples

create_global_incident_handle

Create a new global incident handle.

INSERT INTO datadog.service_management.incident_global_incident_handles (
data,
include
)
SELECT 
'{{ data }}' /* required */,
'{{ include }}'
RETURNING
data,
included
;

Manifest

# Description fields are for documentation purposes
- name: incident_global_incident_handles
props:
  - name: data
    description: |
      Data object representing an incident handle in a create or update request.
    value:
      attributes:
        fields:
          severity:
            - "{{ severity }}"
        name: "{{ name }}"
      id: "{{ id }}"
      relationships:
        commander_user:
          data:
            id: "{{ id }}"
            type: "{{ type }}"
        incident_type:
          data:
            id: "{{ id }}"
            type: "{{ type }}"
      type: "{{ type }}"
  - name: include
    value: "{{ include }}"
    description: Comma-separated list of related resources to include in the response
    description: Comma-separated list of related resources to include in the response

REPLACE examples

update_global_incident_handle

Update an existing global incident handle.

REPLACE datadog.service_management.incident_global_incident_handles
SET 
data = '{{ data }}'
WHERE 
data = '{{ data }}' --required
AND include = '{{ include}}'
RETURNING
data,
included;

DELETE examples

delete_global_incident_handle

Delete a global incident handle.

DELETE FROM datadog.service_management.incident_global_incident_handles
;