/jobs/{jobId}/targets - AWS IoT Wireless

Associates a group with a continuous job. The following criteria must be met:

The job must have been created with the targetSelection field set to "CONTINUOUS".
The job status must currently be "IN_PROGRESS".
The total number of targets associated with a job must not exceed 100.

Requires permission to access the AssociateTargetsWithJob action.

curl --location -g --request POST 'https://api.iotwireless.{region}.amazonaws.com/jobs//targets' \ --header 'Content-Type: application/json' \ --data-raw '{ "targets": [ "string" ], "comment": "string" }'

Request

Path Params

jobId

string

required

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

Query Params

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/

Body Params application/json

targets

array[string]

required

A list of thing group ARNs that define the targets of the job.

>= 1 items

comment

string

optional

An optional comment string describing why the job was associated with the targets.

<= 2028 characters

Match pattern:

[^\p{C}]+

Examples

Responses

🟢200Success

application/json

Body

jobArn

string

optional

An ARN identifying the job.

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_-]+

description

string

optional

A short text description of the job.

<= 2028 characters

Match pattern:

[^\p{C}]+

🟠480InvalidRequestException

🟠481ResourceNotFoundException

🟠482LimitExceededException

🟠483ThrottlingException

🟠484ServiceUnavailableException