/AWS1/CL_IOTJOB¶
The Job object contains details about a job.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_jobarn TYPE /AWS1/IOTJOBARN /AWS1/IOTJOBARN¶
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
iv_jobid TYPE /AWS1/IOTJOBID /AWS1/IOTJOBID¶
The unique identifier you assigned to this job when it was created.
iv_targetselection TYPE /AWS1/IOTTARGETSELECTION /AWS1/IOTTARGETSELECTION¶
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.
We recommend that you use continuous jobs instead of snapshot jobs for dynamic thing group targets. By using continuous jobs, devices that join the group receive the job execution even after the job has been created.
iv_status TYPE /AWS1/IOTJOBSTATUS /AWS1/IOTJOBSTATUS¶
The status of the job, one of
IN_PROGRESS,CANCELED,DELETION_IN_PROGRESSorCOMPLETED.
iv_forcecanceled TYPE /AWS1/IOTFORCED /AWS1/IOTFORCED¶
Will be
trueif the job was canceled with the optionalforceparameter set totrue.
iv_reasoncode TYPE /AWS1/IOTREASONCODE /AWS1/IOTREASONCODE¶
If the job was updated, provides the reason code for the update.
iv_comment TYPE /AWS1/IOTCOMMENT /AWS1/IOTCOMMENT¶
If the job was updated, describes the reason for the update.
it_targets TYPE /AWS1/CL_IOTJOBTARGETS_W=>TT_JOBTARGETS TT_JOBTARGETS¶
A list of IoT things and thing groups to which the job should be sent.
iv_description TYPE /AWS1/IOTJOBDESCRIPTION /AWS1/IOTJOBDESCRIPTION¶
A short text description of the job.
io_presignedurlconfig TYPE REF TO /AWS1/CL_IOTPRESIGNEDURLCONFIG /AWS1/CL_IOTPRESIGNEDURLCONFIG¶
Configuration for pre-signed S3 URLs.
io_jobexecsrolloutconfig TYPE REF TO /AWS1/CL_IOTJOBEXECSRLOUTCFG /AWS1/CL_IOTJOBEXECSRLOUTCFG¶
Allows you to create a staged rollout of a job.
io_abortconfig TYPE REF TO /AWS1/CL_IOTABORTCONFIG /AWS1/CL_IOTABORTCONFIG¶
Configuration for criteria to abort the job.
iv_createdat TYPE /AWS1/IOTDATETYPE /AWS1/IOTDATETYPE¶
The time, in seconds since the epoch, when the job was created.
iv_lastupdatedat TYPE /AWS1/IOTDATETYPE /AWS1/IOTDATETYPE¶
The time, in seconds since the epoch, when the job was last updated.
iv_completedat TYPE /AWS1/IOTDATETYPE /AWS1/IOTDATETYPE¶
The time, in seconds since the epoch, when the job was completed.
io_jobprocessdetails TYPE REF TO /AWS1/CL_IOTJOBPROCESSDETAILS /AWS1/CL_IOTJOBPROCESSDETAILS¶
Details about the job process.
io_timeoutconfig TYPE REF TO /AWS1/CL_IOTTIMEOUTCONFIG /AWS1/CL_IOTTIMEOUTCONFIG¶
Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to
IN_PROGRESS. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set toTIMED_OUT.
iv_namespaceid TYPE /AWS1/IOTNAMESPACEID /AWS1/IOTNAMESPACEID¶
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
namespaceIdfeature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
iv_jobtemplatearn TYPE /AWS1/IOTJOBTEMPLATEARN /AWS1/IOTJOBTEMPLATEARN¶
The ARN of the job template used to create the job.
io_jobexecutionsretryconfig TYPE REF TO /AWS1/CL_IOTJOBEXECSRETRYCFG /AWS1/CL_IOTJOBEXECSRETRYCFG¶
The configuration for the criteria to retry the job.
it_documentparameters TYPE /AWS1/CL_IOTPARAMETERMAP_W=>TT_PARAMETERMAP TT_PARAMETERMAP¶
A key-value map that pairs the patterns that need to be replaced in a managed template job document schema. You can use the description of each key as a guidance to specify the inputs during runtime when creating a job.
documentParameterscan only be used when creating jobs from Amazon Web Services managed templates. This parameter can't be used with custom job templates or to create jobs from them.
iv_isconcurrent TYPE /AWS1/IOTBOOLEANWRAPPEROBJECT /AWS1/IOTBOOLEANWRAPPEROBJECT¶
Indicates whether a job is concurrent. Will be true when a job is rolling out new job executions or canceling previously created executions, otherwise false.
io_schedulingconfig TYPE REF TO /AWS1/CL_IOTSCHEDULINGCONFIG /AWS1/CL_IOTSCHEDULINGCONFIG¶
The configuration that allows you to schedule a job for a future date and time in addition to specifying the end behavior for each job execution.
it_scheduledjobrollouts TYPE /AWS1/CL_IOTSCHDDJOBROLLOUT=>TT_SCHEDULEDJOBROLLOUTLIST TT_SCHEDULEDJOBROLLOUTLIST¶
Displays the next seven maintenance window occurrences and their start times.
it_dstpackageversions TYPE /AWS1/CL_IOTDSTPACKAGEVRSS_W=>TT_DESTINATIONPACKAGEVERSIONS TT_DESTINATIONPACKAGEVERSIONS¶
The package version Amazon Resource Names (ARNs) that are installed on the device when the job successfully completes. The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.
Note:The following Length Constraints relates to a single ARN. Up to 25 package version ARNs are allowed.
Queryable Attributes¶
jobArn¶
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBARN() |
Getter for JOBARN, with configurable default |
ASK_JOBARN() |
Getter for JOBARN w/ exceptions if field has no value |
HAS_JOBARN() |
Determine if JOBARN has a value |
jobId¶
The unique identifier you assigned to this job when it was created.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBID() |
Getter for JOBID, with configurable default |
ASK_JOBID() |
Getter for JOBID w/ exceptions if field has no value |
HAS_JOBID() |
Determine if JOBID has a value |
targetSelection¶
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.
We recommend that you use continuous jobs instead of snapshot jobs for dynamic thing group targets. By using continuous jobs, devices that join the group receive the job execution even after the job has been created.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TARGETSELECTION() |
Getter for TARGETSELECTION, with configurable default |
ASK_TARGETSELECTION() |
Getter for TARGETSELECTION w/ exceptions if field has no val |
HAS_TARGETSELECTION() |
Determine if TARGETSELECTION has a value |
status¶
The status of the job, one of
IN_PROGRESS,CANCELED,DELETION_IN_PROGRESSorCOMPLETED.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STATUS() |
Getter for STATUS, with configurable default |
ASK_STATUS() |
Getter for STATUS w/ exceptions if field has no value |
HAS_STATUS() |
Determine if STATUS has a value |
forceCanceled¶
Will be
trueif the job was canceled with the optionalforceparameter set totrue.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FORCECANCELED() |
Getter for FORCECANCELED, with configurable default |
ASK_FORCECANCELED() |
Getter for FORCECANCELED w/ exceptions if field has no value |
HAS_FORCECANCELED() |
Determine if FORCECANCELED has a value |
reasonCode¶
If the job was updated, provides the reason code for the update.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_REASONCODE() |
Getter for REASONCODE, with configurable default |
ASK_REASONCODE() |
Getter for REASONCODE w/ exceptions if field has no value |
HAS_REASONCODE() |
Determine if REASONCODE has a value |
comment¶
If the job was updated, describes the reason for the update.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_COMMENT() |
Getter for COMMENT, with configurable default |
ASK_COMMENT() |
Getter for COMMENT w/ exceptions if field has no value |
HAS_COMMENT() |
Determine if COMMENT has a value |
targets¶
A list of IoT things and thing groups to which the job should be sent.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TARGETS() |
Getter for TARGETS, with configurable default |
ASK_TARGETS() |
Getter for TARGETS w/ exceptions if field has no value |
HAS_TARGETS() |
Determine if TARGETS has a value |
description¶
A short text description of the job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DESCRIPTION() |
Getter for DESCRIPTION, with configurable default |
ASK_DESCRIPTION() |
Getter for DESCRIPTION w/ exceptions if field has no value |
HAS_DESCRIPTION() |
Determine if DESCRIPTION has a value |
presignedUrlConfig¶
Configuration for pre-signed S3 URLs.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PRESIGNEDURLCONFIG() |
Getter for PRESIGNEDURLCONFIG |
jobExecutionsRolloutConfig¶
Allows you to create a staged rollout of a job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBEXECSROLLOUTCONFIG() |
Getter for JOBEXECUTIONSROLLOUTCONFIG |
abortConfig¶
Configuration for criteria to abort the job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ABORTCONFIG() |
Getter for ABORTCONFIG |
createdAt¶
The time, in seconds since the epoch, when the job was created.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CREATEDAT() |
Getter for CREATEDAT, with configurable default |
ASK_CREATEDAT() |
Getter for CREATEDAT w/ exceptions if field has no value |
HAS_CREATEDAT() |
Determine if CREATEDAT has a value |
lastUpdatedAt¶
The time, in seconds since the epoch, when the job was last updated.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTUPDATEDAT() |
Getter for LASTUPDATEDAT, with configurable default |
ASK_LASTUPDATEDAT() |
Getter for LASTUPDATEDAT w/ exceptions if field has no value |
HAS_LASTUPDATEDAT() |
Determine if LASTUPDATEDAT has a value |
completedAt¶
The time, in seconds since the epoch, when the job was completed.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_COMPLETEDAT() |
Getter for COMPLETEDAT, with configurable default |
ASK_COMPLETEDAT() |
Getter for COMPLETEDAT w/ exceptions if field has no value |
HAS_COMPLETEDAT() |
Determine if COMPLETEDAT has a value |
jobProcessDetails¶
Details about the job process.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBPROCESSDETAILS() |
Getter for JOBPROCESSDETAILS |
timeoutConfig¶
Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to
IN_PROGRESS. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set toTIMED_OUT.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TIMEOUTCONFIG() |
Getter for TIMEOUTCONFIG |
namespaceId¶
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
namespaceIdfeature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NAMESPACEID() |
Getter for NAMESPACEID, with configurable default |
ASK_NAMESPACEID() |
Getter for NAMESPACEID w/ exceptions if field has no value |
HAS_NAMESPACEID() |
Determine if NAMESPACEID has a value |
jobTemplateArn¶
The ARN of the job template used to create the job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBTEMPLATEARN() |
Getter for JOBTEMPLATEARN, with configurable default |
ASK_JOBTEMPLATEARN() |
Getter for JOBTEMPLATEARN w/ exceptions if field has no valu |
HAS_JOBTEMPLATEARN() |
Determine if JOBTEMPLATEARN has a value |
jobExecutionsRetryConfig¶
The configuration for the criteria to retry the job.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBEXECUTIONSRETRYCONFIG() |
Getter for JOBEXECUTIONSRETRYCONFIG |
documentParameters¶
A key-value map that pairs the patterns that need to be replaced in a managed template job document schema. You can use the description of each key as a guidance to specify the inputs during runtime when creating a job.
documentParameterscan only be used when creating jobs from Amazon Web Services managed templates. This parameter can't be used with custom job templates or to create jobs from them.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DOCUMENTPARAMETERS() |
Getter for DOCUMENTPARAMETERS, with configurable default |
ASK_DOCUMENTPARAMETERS() |
Getter for DOCUMENTPARAMETERS w/ exceptions if field has no |
HAS_DOCUMENTPARAMETERS() |
Determine if DOCUMENTPARAMETERS has a value |
isConcurrent¶
Indicates whether a job is concurrent. Will be true when a job is rolling out new job executions or canceling previously created executions, otherwise false.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ISCONCURRENT() |
Getter for ISCONCURRENT, with configurable default |
ASK_ISCONCURRENT() |
Getter for ISCONCURRENT w/ exceptions if field has no value |
HAS_ISCONCURRENT() |
Determine if ISCONCURRENT has a value |
schedulingConfig¶
The configuration that allows you to schedule a job for a future date and time in addition to specifying the end behavior for each job execution.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SCHEDULINGCONFIG() |
Getter for SCHEDULINGCONFIG |
scheduledJobRollouts¶
Displays the next seven maintenance window occurrences and their start times.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SCHEDULEDJOBROLLOUTS() |
Getter for SCHEDULEDJOBROLLOUTS, with configurable default |
ASK_SCHEDULEDJOBROLLOUTS() |
Getter for SCHEDULEDJOBROLLOUTS w/ exceptions if field has n |
HAS_SCHEDULEDJOBROLLOUTS() |
Determine if SCHEDULEDJOBROLLOUTS has a value |
destinationPackageVersions¶
The package version Amazon Resource Names (ARNs) that are installed on the device when the job successfully completes. The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.
Note:The following Length Constraints relates to a single ARN. Up to 25 package version ARNs are allowed.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DSTPACKAGEVERSIONS() |
Getter for DESTINATIONPACKAGEVERSIONS, with configurable def |
ASK_DSTPACKAGEVERSIONS() |
Getter for DESTINATIONPACKAGEVERSIONS w/ exceptions if field |
HAS_DSTPACKAGEVERSIONS() |
Determine if DESTINATIONPACKAGEVERSIONS has a value |