job_executions_for_things

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

Overview

Name	job_executions_for_things
Type	Resource
Id	aws.iot.job_executions_for_things

Fields

The following fields are returned by SELECT queries:

list_job_executions_for_thing

Name	Datatype	Description
job_execution_summary	object	Contains a subset of information about a job execution.
job_id	string	The unique identifier you assigned to this job when it was created. (pattern: <code>[a-zA-Z0-9_-]+</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_job_executions_for_thing	select	thing_name, region	status, namespaceId, maxResults, nextToken, jobId	Lists the job executions for the specified thing. Requires permission to access the ListJobExecutionsForThing action.

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
region	string	AWS region (default: us-east-1)
thing_name	string	The thing name.
jobId	string	The unique identifier you assigned to this job when it was created.
maxResults	integer	The maximum number of results to be returned per request.
namespaceId	string	The namespace used to indicate that a job is a customer-managed job. When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format. $aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/ The namespaceId feature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
nextToken	string	The token to retrieve the next set of results.
status	string	An optional filter that lets you search for jobs that have the specified status.

SELECT examples

list_job_executions_for_thing

Lists the job executions for the specified thing. Requires permission to access the ListJobExecutionsForThing action.

SELECT
job_execution_summary,
job_id
FROM aws.iot.job_executions_for_things
WHERE thing_name = '{{ thing_name }}' -- required
AND region = '{{ region }}' -- required
AND status = '{{ status }}'
AND namespaceId = '{{ namespaceId }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
AND jobId = '{{ jobId }}'
;