servicenow_handles

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

Overview

Name	servicenow_handles
Type	Resource
Id	datadog.integrations.servicenow_handles

Fields

The following fields are returned by SELECT queries:

get_service_now_template

Name	Datatype	Description
id	string (uuid)	Unique identifier for the ServiceNow template (example: 65b3341b-0680-47f9-a6d4-134db45c603e)
attributes	object	Attributes of a ServiceNow template
type	string	Type identifier for ServiceNow template resources (servicenow_templates) (example: servicenow_templates)

list_service_now_templates

Name	Datatype	Description
id	string (uuid)	Unique identifier for the ServiceNow template (example: 65b3341b-0680-47f9-a6d4-134db45c603e)
attributes	object	Attributes of a ServiceNow template
type	string	Type identifier for ServiceNow template resources (servicenow_templates) (example: servicenow_templates)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_service_now_template	select	template_id		Get a ServiceNow template by ID.
list_service_now_templates	select			Get all ServiceNow templates for the organization.
create_service_now_template	insert	data		Create a new ServiceNow template.
update_service_now_template	replace	template_id, data		Update a ServiceNow template by ID.
delete_service_now_template	delete	template_id		Delete a ServiceNow template by ID.

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.
template_id	string (uuid)	The ID of the ServiceNow template to delete (example: 65b3341b-0680-47f9-a6d4-134db45c603e)

SELECT examples

get_service_now_template

Get a ServiceNow template by ID.

SELECT
id,
attributes,
type
FROM datadog.integrations.servicenow_handles
WHERE template_id = '{{ template_id }}' -- required
;

list_service_now_templates

Get all ServiceNow templates for the organization.

SELECT
id,
attributes,
type
FROM datadog.integrations.servicenow_handles
;

INSERT examples

create_service_now_template

Create a new ServiceNow template.

INSERT INTO datadog.integrations.servicenow_handles (
data
)
SELECT 
'{{ data }}' /* required */
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: servicenow_handles
props:
  - name: data
    description: |
      Data object for creating a ServiceNow template
    value:
      attributes:
        assignment_group_id: "{{ assignment_group_id }}"
        business_service_id: "{{ business_service_id }}"
        fields_mapping: "{{ fields_mapping }}"
        handle_name: "{{ handle_name }}"
        instance_id: "{{ instance_id }}"
        servicenow_tablename: "{{ servicenow_tablename }}"
        user_id: "{{ user_id }}"
      type: "{{ type }}"

REPLACE examples

update_service_now_template

Update a ServiceNow template by ID.

REPLACE datadog.integrations.servicenow_handles
SET 
data = '{{ data }}'
WHERE 
template_id = '{{ template_id }}' --required
AND data = '{{ data }}' --required
RETURNING
data;

DELETE examples

delete_service_now_template

Delete a ServiceNow template by ID.

DELETE FROM datadog.integrations.servicenow_handles
WHERE template_id = '{{ template_id }}' --required
;