workflow_instances

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

Overview

Name	workflow_instances
Type	Resource
Id	datadog.software_delivery.workflow_instances

Fields

The following fields are returned by SELECT queries:

get_workflow_instance

Name	Datatype	Description
attributes	object	The attributes of the instance response data.

list_workflow_instances

Name	Datatype	Description
id	string	The ID of the workflow instance

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_workflow_instance	select	workflow_id, instance_id, region		Get a specific execution of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
list_workflow_instances	select	workflow_id, region	page[size], page[number]	List all instances of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
create_workflow_instance	insert	workflow_id, region		Execute the given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
cancel_workflow_instance	exec	workflow_id, instance_id, region		Cancels a specific execution of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.

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
instance_id	string	The ID of the workflow instance.
region	string	(default: datadoghq.com)
workflow_id	string	The ID of the workflow.
page[number]	integer (int64)	Specific page number to return.
page[size]	integer (int64)	Size for a given page. The maximum allowed value is 100.

SELECT examples

get_workflow_instance

Get a specific execution of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.

SELECT
attributes
FROM datadog.software_delivery.workflow_instances
WHERE workflow_id = '{{ workflow_id }}' -- required
AND instance_id = '{{ instance_id }}' -- required
AND region = '{{ region }}' -- required
;

list_workflow_instances

List all instances of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.

SELECT
id
FROM datadog.software_delivery.workflow_instances
WHERE workflow_id = '{{ workflow_id }}' -- required
AND region = '{{ region }}' -- required
AND page[size] = '{{ page[size] }}'
AND page[number] = '{{ page[number] }}'
;

INSERT examples

create_workflow_instance

Execute the given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.

INSERT INTO datadog.software_delivery.workflow_instances (
data__meta,
workflow_id,
region
)
SELECT 
'{{ meta }}',
'{{ workflow_id }}',
'{{ region }}'
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: workflow_instances
  props:
    - name: workflow_id
      value: string
      description: Required parameter for the workflow_instances resource.
    - name: region
      value: string
      description: Required parameter for the workflow_instances resource.
    - name: meta
      value: object
      description: |
        Additional information for creating a workflow instance.

Lifecycle Methods

cancel_workflow_instance

Cancels a specific execution of a given workflow. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.

EXEC datadog.software_delivery.workflow_instances.cancel_workflow_instance 
@workflow_id='{{ workflow_id }}' --required, 
@instance_id='{{ instance_id }}' --required, 
@region='{{ region }}' --required
;