What is Amazon IoT Jobs? - Amazon IoT Core
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

What is Amazon IoT Jobs?

Use Amazon IoT Jobs to define a set of remote operations that can be sent to and run on one or more devices connected to Amazon IoT.

To create jobs, first define a job document that contains a list of instructions describing operations that the device must perform remotely. To perform these operations, specify a list of targets, which are individual things, thing groups, or both. The job document and targets together constitute a deployment.

Each deployment can have additional configurations:

  • Rollout: This configuration defines how many devices receive the job document every minute.

  • Abort: If a certain number of devices don't receive the job notification, use this configuration to cancel the job. This avoids sending a bad update to an entire fleet.

  • Timeout: If a response isn't received from your job targets within a certain duration, the job can fail. You can track the job that's running on these devices.

  • Retry: If a device reports failure or a job times out, you can use Amazon IoT Jobs to resend the job document to the device automatically.

  • Scheduling: This configuration enables you to schedule a job for a future date and time. It also enables you to create recurring maintenance windows that update devices during predefined, low-traffic periods.

Amazon IoT Jobs sends a message to inform the targets that a job is available. The target starts the execution of the job by downloading the job document, performing the operations it specifies, and reporting its progress to Amazon IoT. You can track the progress of a job for a specific target or for all targets by running commands that are provided by Amazon IoT Jobs. When a job starts, it has a status of In progress. The devices then report incremental updates while displaying this status until the job succeeds, fails, or times out.

The following topics describe some key concepts of jobs and the lifecycle of jobs and job executions.