@Generated(value="software.amazon.awssdk:codegen") public final class JobDetail extends Object implements SdkPojo, Serializable, ToCopyableBuilder<JobDetail.Builder,JobDetail>
An object representing an Batch job.
Modifier and Type | Class and Description |
---|---|
static interface |
JobDetail.Builder |
Modifier and Type | Method and Description |
---|---|
ArrayPropertiesDetail |
arrayProperties()
The array properties of the job, if it is an array job.
|
List<AttemptDetail> |
attempts()
A list of job attempts associated with this job.
|
static JobDetail.Builder |
builder() |
ContainerDetail |
container()
An object representing the details of the container that's associated with the job.
|
Long |
createdAt()
The Unix timestamp (in milliseconds) for when the job was created.
|
List<JobDependency> |
dependsOn()
A list of job IDs that this job depends on.
|
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
boolean |
hasAttempts()
For responses, this returns true if the service returned a value for the Attempts property.
|
boolean |
hasDependsOn()
For responses, this returns true if the service returned a value for the DependsOn property.
|
int |
hashCode() |
boolean |
hasParameters()
For responses, this returns true if the service returned a value for the Parameters property.
|
boolean |
hasPlatformCapabilities()
For responses, this returns true if the service returned a value for the PlatformCapabilities property.
|
boolean |
hasTags()
For responses, this returns true if the service returned a value for the Tags property.
|
String |
jobArn()
The Amazon Resource Name (ARN) of the job.
|
String |
jobDefinition()
The Amazon Resource Name (ARN) of the job definition that's used by this job.
|
String |
jobId()
The ID for the job.
|
String |
jobName()
The name of the job.
|
String |
jobQueue()
The Amazon Resource Name (ARN) of the job queue that the job is associated with.
|
NodeDetails |
nodeDetails()
An object representing the details of a node that's associated with a multi-node parallel job.
|
NodeProperties |
nodeProperties()
An object representing the node properties of a multi-node parallel job.
|
Map<String,String> |
parameters()
Additional parameters passed to the job that replace parameter substitution placeholders or override any
corresponding parameter defaults from the job definition.
|
List<PlatformCapability> |
platformCapabilities()
The platform capabilities required by the job definition.
|
List<String> |
platformCapabilitiesAsStrings()
The platform capabilities required by the job definition.
|
Boolean |
propagateTags()
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
|
RetryStrategy |
retryStrategy()
The retry strategy to use for this job if an attempt fails.
|
Integer |
schedulingPriority()
The scheduling policy of the job definition.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends JobDetail.Builder> |
serializableBuilderClass() |
String |
shareIdentifier()
The share identifier for the job.
|
Long |
startedAt()
The Unix timestamp (in milliseconds) for when the job was started (when the job transitioned from the
STARTING state to the RUNNING state). |
JobStatus |
status()
The current status for the job.
|
String |
statusAsString()
The current status for the job.
|
String |
statusReason()
A short, human-readable string to provide additional details about the current status of the job.
|
Long |
stoppedAt()
The Unix timestamp (in milliseconds) for when the job was stopped (when the job transitioned from the
RUNNING state to a terminal state, such as SUCCEEDED or FAILED ). |
Map<String,String> |
tags()
The tags applied to the job.
|
JobTimeout |
timeout()
The timeout configuration for the job.
|
JobDetail.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copy
public final String jobArn()
The Amazon Resource Name (ARN) of the job.
public final String jobName()
The name of the job.
public final String jobId()
The ID for the job.
public final String jobQueue()
The Amazon Resource Name (ARN) of the job queue that the job is associated with.
public final JobStatus status()
The current status for the job.
If your jobs don't progress to STARTING
, see Jobs stuck
in RUNNABLE status in the troubleshooting section of the Batch User Guide.
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()
.
If your jobs don't progress to STARTING
, see Jobs
stuck in RUNNABLE status in the troubleshooting section of the Batch User Guide.
JobStatus
public final String statusAsString()
The current status for the job.
If your jobs don't progress to STARTING
, see Jobs stuck
in RUNNABLE status in the troubleshooting section of the Batch User Guide.
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()
.
If your jobs don't progress to STARTING
, see Jobs
stuck in RUNNABLE status in the troubleshooting section of the Batch User Guide.
JobStatus
public final String shareIdentifier()
The share identifier for the job.
public final Integer schedulingPriority()
The scheduling policy of the job definition. This only affects jobs in job queues with a fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower scheduling priority.
public final boolean hasAttempts()
isEmpty()
method on the property). This is
useful because the SDK will never return a null collection or map, but you may need to differentiate between the
service returning nothing (or null) and the service returning an empty collection or map. For requests, this
returns true if a value for the property was specified in the request builder, and false if a value was not
specified.public final List<AttemptDetail> attempts()
A list of job attempts associated with this job.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasAttempts()
method.
public final String statusReason()
A short, human-readable string to provide additional details about the current status of the job.
public final Long createdAt()
The Unix timestamp (in milliseconds) for when the job was created. For non-array jobs and parent array jobs, this
is when the job entered the SUBMITTED
state (at the time SubmitJob was called). For array
child jobs, this is when the child job was spawned by its parent and entered the PENDING
state.
SUBMITTED
state (at the time SubmitJob was
called). For array child jobs, this is when the child job was spawned by its parent and entered the
PENDING
state.public final RetryStrategy retryStrategy()
The retry strategy to use for this job if an attempt fails.
public final Long startedAt()
The Unix timestamp (in milliseconds) for when the job was started (when the job transitioned from the
STARTING
state to the RUNNING
state). This parameter isn't provided for child jobs of
array jobs or multi-node parallel jobs.
STARTING
state to the RUNNING
state). This parameter isn't provided for child
jobs of array jobs or multi-node parallel jobs.public final Long stoppedAt()
The Unix timestamp (in milliseconds) for when the job was stopped (when the job transitioned from the
RUNNING
state to a terminal state, such as SUCCEEDED
or FAILED
).
RUNNING
state to a terminal state, such as SUCCEEDED
or FAILED
).public final boolean hasDependsOn()
isEmpty()
method on the property). This is
useful because the SDK will never return a null collection or map, but you may need to differentiate between the
service returning nothing (or null) and the service returning an empty collection or map. For requests, this
returns true if a value for the property was specified in the request builder, and false if a value was not
specified.public final List<JobDependency> dependsOn()
A list of job IDs that this job depends on.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasDependsOn()
method.
public final String jobDefinition()
The Amazon Resource Name (ARN) of the job definition that's used by this job.
public final boolean hasParameters()
isEmpty()
method on the property). This is
useful because the SDK will never return a null collection or map, but you may need to differentiate between the
service returning nothing (or null) and the service returning an empty collection or map. For requests, this
returns true if a value for the property was specified in the request builder, and false if a value was not
specified.public final Map<String,String> parameters()
Additional parameters passed to the job that replace parameter substitution placeholders or override any corresponding parameter defaults from the job definition.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasParameters()
method.
public final ContainerDetail container()
An object representing the details of the container that's associated with the job.
public final NodeDetails nodeDetails()
An object representing the details of a node that's associated with a multi-node parallel job.
public final NodeProperties nodeProperties()
An object representing the node properties of a multi-node parallel job.
This isn't applicable to jobs that are running on Fargate resources.
This isn't applicable to jobs that are running on Fargate resources.
public final ArrayPropertiesDetail arrayProperties()
The array properties of the job, if it is an array job.
public final JobTimeout timeout()
The timeout configuration for the job.
public final boolean hasTags()
isEmpty()
method on the property). This is useful
because the SDK will never return a null collection or map, but you may need to differentiate between the service
returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true
if a value for the property was specified in the request builder, and false if a value was not specified.public final Map<String,String> tags()
The tags applied to the job.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasTags()
method.
public final Boolean propagateTags()
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If
no value is specified, the tags aren't propagated. Tags can only be propagated to the tasks during task creation.
For tags with the same name, job tags are given priority over job definitions tags. If the total number of
combined tags from the job and job definition is over 50, the job is moved to the FAILED
state.
FAILED
state.public final List<PlatformCapability> platformCapabilities()
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2
. Jobs run on Fargate resources specify FARGATE
.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasPlatformCapabilities()
method.
EC2
. Jobs run on Fargate resources specify FARGATE
.public final boolean hasPlatformCapabilities()
isEmpty()
method on the property).
This is useful because the SDK will never return a null collection or map, but you may need to differentiate
between the service returning nothing (or null) and the service returning an empty collection or map. For
requests, this returns true if a value for the property was specified in the request builder, and false if a
value was not specified.public final List<String> platformCapabilitiesAsStrings()
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2
. Jobs run on Fargate resources specify FARGATE
.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasPlatformCapabilities()
method.
EC2
. Jobs run on Fargate resources specify FARGATE
.public JobDetail.Builder toBuilder()
toBuilder
in interface ToCopyableBuilder<JobDetail.Builder,JobDetail>
public static JobDetail.Builder builder()
public static Class<? extends JobDetail.Builder> serializableBuilderClass()
public final boolean equalsBySdkFields(Object obj)
equalsBySdkFields
in interface SdkPojo
public final String toString()
Copyright © 2022. All rights reserved.