@Generated(value="software.amazon.awssdk:codegen") public final class Job extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Job.Builder,Job>
The Job
object contains details about a job.
Modifier and Type | Class and Description |
---|---|
static interface |
Job.Builder |
Modifier and Type | Method and Description |
---|---|
AbortConfig |
abortConfig()
Configuration for criteria to abort the job.
|
static Job.Builder |
builder() |
String |
comment()
If the job was updated, describes the reason for the update.
|
Instant |
completedAt()
The time, in seconds since the epoch, when the job was completed.
|
Instant |
createdAt()
The time, in seconds since the epoch, when the job was created.
|
String |
description()
A short text description of the job.
|
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
Boolean |
forceCanceled()
Will be
true if the job was canceled with the optional force parameter set to
true . |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
int |
hashCode() |
String |
jobArn()
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
|
JobExecutionsRolloutConfig |
jobExecutionsRolloutConfig()
Allows you to create a staged rollout of a job.
|
String |
jobId()
The unique identifier you assigned to this job when it was created.
|
JobProcessDetails |
jobProcessDetails()
Details about the job process.
|
Instant |
lastUpdatedAt()
The time, in seconds since the epoch, when the job was last updated.
|
PresignedUrlConfig |
presignedUrlConfig()
Configuration for pre-signed S3 URLs.
|
String |
reasonCode()
If the job was updated, provides the reason code for the update.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends Job.Builder> |
serializableBuilderClass() |
JobStatus |
status()
The status of the job, one of
IN_PROGRESS , CANCELED , DELETION_IN_PROGRESS
or COMPLETED . |
String |
statusAsString()
The status of the job, one of
IN_PROGRESS , CANCELED , DELETION_IN_PROGRESS
or COMPLETED . |
List<String> |
targets()
A list of IoT things and thing groups to which the job should be sent.
|
TargetSelection |
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).
|
String |
targetSelectionAsString()
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).
|
TimeoutConfig |
timeoutConfig()
Specifies the amount of time each device has to finish its execution of the job.
|
Job.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copy
public String jobArn()
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
public String jobId()
The unique identifier you assigned to this job when it was created.
public TargetSelection 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.
If the service returns an enum value that is not available in the current SDK version, targetSelection
will return TargetSelection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available
from targetSelectionAsString()
.
TargetSelection
public String targetSelectionAsString()
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.
If the service returns an enum value that is not available in the current SDK version, targetSelection
will return TargetSelection.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available
from targetSelectionAsString()
.
TargetSelection
public JobStatus status()
The status of the job, one of IN_PROGRESS
, CANCELED
, DELETION_IN_PROGRESS
or COMPLETED
.
If the service returns an enum value that is not available in the current SDK version, status
will
return JobStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statusAsString()
.
IN_PROGRESS
, CANCELED
,
DELETION_IN_PROGRESS
or COMPLETED
.JobStatus
public String statusAsString()
The status of the job, one of IN_PROGRESS
, CANCELED
, DELETION_IN_PROGRESS
or COMPLETED
.
If the service returns an enum value that is not available in the current SDK version, status
will
return JobStatus.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statusAsString()
.
IN_PROGRESS
, CANCELED
,
DELETION_IN_PROGRESS
or COMPLETED
.JobStatus
public Boolean forceCanceled()
Will be true
if the job was canceled with the optional force
parameter set to
true
.
true
if the job was canceled with the optional force
parameter set to
true
.public String reasonCode()
If the job was updated, provides the reason code for the update.
public String comment()
If the job was updated, describes the reason for the update.
public List<String> targets()
A list of IoT things and thing groups to which the job should be sent.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
public String description()
A short text description of the job.
public PresignedUrlConfig presignedUrlConfig()
Configuration for pre-signed S3 URLs.
public JobExecutionsRolloutConfig jobExecutionsRolloutConfig()
Allows you to create a staged rollout of a job.
public AbortConfig abortConfig()
Configuration for criteria to abort the job.
public Instant createdAt()
The time, in seconds since the epoch, when the job was created.
public Instant lastUpdatedAt()
The time, in seconds since the epoch, when the job was last updated.
public Instant completedAt()
The time, in seconds since the epoch, when the job was completed.
public JobProcessDetails jobProcessDetails()
Details about the job process.
public TimeoutConfig 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 to TIMED_OUT
.
IN_PROGRESS
. If the job execution status is not set to
another terminal state before the timer expires, it will be automatically set to TIMED_OUT
.public Job.Builder toBuilder()
toBuilder
in interface ToCopyableBuilder<Job.Builder,Job>
public static Job.Builder builder()
public static Class<? extends Job.Builder> serializableBuilderClass()
public boolean equalsBySdkFields(Object obj)
equalsBySdkFields
in interface SdkPojo
public String toString()
Copyright © 2019. All rights reserved.