@Generated(value="software.amazon.awssdk:codegen") public final class JobDetail extends Object implements SdkPojo, Serializable, ToCopyableBuilder<JobDetail.Builder,JobDetail>
An object that represents 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's an array job.
|
List<AttemptDetail> |
attempts()
A list of job attempts that are associated with this job.
|
static JobDetail.Builder |
builder() |
ContainerDetail |
container()
An object that represents the details for 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.
|
List<EksAttemptDetail> |
eksAttempts()
A list of job attempts that are associated with this job.
|
EksPropertiesDetail |
eksProperties()
An object with various properties that are specific to Amazon EKS based jobs.
|
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.
|
boolean |
hasEksAttempts()
For responses, this returns true if the service returned a value for the EksAttempts 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.
|
Boolean |
isCancelled()
Indicates whether the job is canceled.
|
Boolean |
isTerminated()
Indicates whether the job is terminated.
|
String |
jobArn()
The Amazon Resource Name (ARN) of the job.
|
String |
jobDefinition()
The Amazon Resource Name (ARN) of the job definition that this job uses.
|
String |
jobId()
The job ID.
|
String |
jobName()
The job name.
|
String |
jobQueue()
The Amazon Resource Name (ARN) of the job queue that the job is associated with.
|
NodeDetails |
nodeDetails()
An object that represents the details of a node that's associated with a multi-node parallel job.
|
NodeProperties |
nodeProperties()
An object that represents the node properties of a multi-node parallel job.
|
Map<String,String> |
parameters()
Additional parameters that are 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.
|
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 more details for the current status of the job.
|
Long |
stoppedAt()
The Unix timestamp (in milliseconds) for when the job was stopped.
|
Map<String,String> |
tags()
The tags that are 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, waitcopypublic final String jobArn()
The Amazon Resource Name (ARN) of the job.
public final String jobName()
The job name.
public final String jobId()
The job ID.
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.
JobStatuspublic 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.
JobStatuspublic 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 that are 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 more details for 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. This is specifically 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. This is specifically 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. More specifically, it's 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. More specifically, it's 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 this job uses.
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 that are 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 that represents the details for the container that's associated with the job.
public final NodeDetails nodeDetails()
An object that represents the details of a node that's associated with a multi-node parallel job.
public final NodeProperties nodeProperties()
An object that represents 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's 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 that are 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 when the tasks are
created. 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 final EksPropertiesDetail eksProperties()
An object with various properties that are specific to Amazon EKS based jobs. Only one of container,
eksProperties, or nodeDetails is specified.
container, eksProperties, or nodeDetails is specified.public final boolean hasEksAttempts()
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<EksAttemptDetail> eksAttempts()
A list of job attempts that are 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 hasEksAttempts() method.
public final Boolean isCancelled()
Indicates whether the job is canceled.
public final Boolean isTerminated()
Indicates whether the job is terminated.
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 SdkPojopublic final String toString()
Copyright © 2023. All rights reserved.