/things/{thingName}/jobs

The AWS IoT Wireless multi-region endpoint

https://api.iotwireless.{region}.amazonaws.com

GET

Lists the job executions for the specified thing.

Requires permission to access the ListJobExecutionsForThing action.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.iotwireless.{region}.amazonaws.com/things//jobs'

Response Example

200 - Example 1

{
    "executionSummaries": [],
    "nextToken": "string"
}

Request

Path Params

thingName

string

required

The thing name.

Query Params

status

string

optional

An optional filter that lets you search for jobs that have the specified status.

namespaceId

string

optional

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/

maxResults

integer

optional

The maximum number of results to be returned per request.

nextToken

string

optional

The token to retrieve the next set of results.

Responses

🟢200Success

application/json

Body

executionSummaries

array[object (JobExecutionSummaryForThing) {2}]

optional

A list of job execution summaries.

jobId

string

optional

The unique identifier you assigned to this job when it was created.

>= 1 characters<= 64 characters

Match pattern:

[a-zA-Z0-9_-]+

jobExecutionSummary

object

optional

Contains a subset of information about a job execution.

nextToken

string

optional

The token for the next set of results, or null if there are no additional results.

<= 4096 characters

🟠480InvalidRequestException

🟠481ResourceNotFoundException

🟠482ThrottlingException

🟠483ServiceUnavailableException

Modified at 2022-09-10 23:12:18

/jobs/{jobId}/things

/job-templates