Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

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.

post/jobs/{jobId}/targets

Path parameters

jobIdstring required

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

Query parameters

namespaceIdstring
<p>The namespace used to indicate that a job is a customer-managed job.</p> <p>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.</p> <p> <code>$aws/things/<i>THING_NAME</i>/jobs/<i>JOB_ID</i>/notify-namespace-<i>NAMESPACE_ID</i>/</code> </p> <note> <p>The <code>namespaceId</code> feature is in public preview.</p> </note>

Request body

targetsTargetArn[] required

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

commentstring

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

Response

Success

jobArnstring

An ARN identifying the job.

jobIdstring

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

descriptionstring

A short text description of the job.