Skip to main content

executions

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

Overview​

Nameexecutions
TypeResource
Idaws.iotsitewise.executions

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
action_typestringThe type of action exectued. (pattern: <code>[^\u0000-\u001F\u007F]+</code>)
execution_end_timestring (date-time)The time the process ended.
execution_entity_versionstringThe execution entity version associated with the summary. (pattern: <code>^(0|([1-9]{1}\d*))$</code>)
execution_idstringThe ID of the execution. (pattern: <code>^(?!00000000-0000-0000-0000-000000000000)[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$</code>)
execution_start_timestring (date-time)The time the process started.
execution_statusobjectThe status of the execution process.
resolve_toobjectThe detailed resource this execution summary resolves to.
target_resourceobjectThe resource the action will be taken on. This can include asset-based resources and computation model resources.
target_resource_versionstringThe version of the target resource. (pattern: <code>^(0|([1-9]{1}\d*))$</code>)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_executionsselecttargetResourceType, targetResourceId, regionresolveToResourceType, resolveToResourceId, nextToken, maxResults, actionTypeRetrieves a paginated list of summaries of all executions.
describe_executionselectexecution_id, regionRetrieves information about the execution.

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
execution_idstringThe ID of the execution.
regionstringAWS region (default: us-east-1)
targetResourceIdstringThe ID of the target resource.
targetResourceTypestringThe type of the target resource.
actionTypestringThe type of action exectued.
maxResultsintegerThe maximum number of results returned for each paginated request.
nextTokenstringThe token used for the next set of paginated results.
resolveToResourceIdstringThe ID of the resolved resource.
resolveToResourceTypestringThe type of the resolved resource.

SELECT examples​

Retrieves a paginated list of summaries of all executions.

SELECT
action_type,
execution_end_time,
execution_entity_version,
execution_id,
execution_start_time,
execution_status,
resolve_to,
target_resource,
target_resource_version
FROM aws.iotsitewise.executions
WHERE targetResourceType = '{{ targetResourceType }}' -- required
AND targetResourceId = '{{ targetResourceId }}' -- required
AND region = '{{ region }}' -- required
AND resolveToResourceType = '{{ resolveToResourceType }}'
AND resolveToResourceId = '{{ resolveToResourceId }}'
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
AND actionType = '{{ actionType }}'
;