change_requests

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

Overview

Name	change_requests
Type	Resource
Id	datadog.service_management.change_requests

Fields

The following fields are returned by SELECT queries:

get_change_request

Name	Datatype	Description
id	string	The identifier of the change request. (example: CHM-1234)
attributes	object	Attributes of a change request response.
relationships	object	Relationships of a change request.
type	string	Change request resource type. (change_request) (example: change_request)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_change_request	select	change_request_id		Get the details of a change request by its ID.
create_change_request	insert	data		Create a new change request.
update_change_request	update	change_request_id, data		Update the properties of a change request.

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
change_request_id	string	The identifier of the change request. (example: CHM-1234)
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.

SELECT examples

get_change_request

Get the details of a change request by its ID.

SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.change_requests
WHERE change_request_id = '{{ change_request_id }}' -- required
;

INSERT examples

create_change_request

Create a new change request.

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

Manifest

# Description fields are for documentation purposes
- name: change_requests
props:
  - name: data
    description: |
      Data object to create a change request.
    value:
      attributes:
        change_request_linked_incident_uuid: "{{ change_request_linked_incident_uuid }}"
        change_request_maintenance_window_query: "{{ change_request_maintenance_window_query }}"
        change_request_plan: "{{ change_request_plan }}"
        change_request_risk: "{{ change_request_risk }}"
        change_request_type: "{{ change_request_type }}"
        description: "{{ description }}"
        end_date: "{{ end_date }}"
        project_id: "{{ project_id }}"
        requested_teams:
          - "{{ requested_teams }}"
        start_date: "{{ start_date }}"
        title: "{{ title }}"
      type: "{{ type }}"

UPDATE examples

update_change_request

Update the properties of a change request.

UPDATE datadog.service_management.change_requests
SET 
data = '{{ data }}',
included = '{{ included }}'
WHERE 
change_request_id = '{{ change_request_id }}' --required
AND data = '{{ data }}' --required
RETURNING
data,
included;