@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class SubmitJobRequest extends AmazonWebServiceRequest implements Serializable, Cloneable
Contains the parameters for SubmitJob
.
NOOP
Constructor and Description |
---|
SubmitJobRequest() |
Modifier and Type | Method and Description |
---|---|
SubmitJobRequest |
addParametersEntry(String key,
String value)
Add a single Parameters entry
|
SubmitJobRequest |
addTagsEntry(String key,
String value)
Add a single Tags entry
|
SubmitJobRequest |
clearParametersEntries()
Removes all the entries added into Parameters.
|
SubmitJobRequest |
clearTagsEntries()
Removes all the entries added into Tags.
|
SubmitJobRequest |
clone()
Creates a shallow clone of this object for all fields except the handler context.
|
boolean |
equals(Object obj) |
ArrayProperties |
getArrayProperties()
The array properties for the submitted job, such as the size of the array.
|
ContainerOverrides |
getContainerOverrides()
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive.
|
List<JobDependency> |
getDependsOn()
A list of dependencies for the job.
|
String |
getJobDefinition()
The job definition used by this job.
|
String |
getJobName()
The name of the job.
|
String |
getJobQueue()
The job queue where the job is submitted.
|
NodeOverrides |
getNodeOverrides()
A list of node overrides in JSON format that specify the node range to target and the container overrides for
that node range.
|
Map<String,String> |
getParameters()
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition.
|
Boolean |
getPropagateTags()
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
|
RetryStrategy |
getRetryStrategy()
The retry strategy to use for failed jobs from this SubmitJob operation.
|
Map<String,String> |
getTags()
The tags that you apply to the job request to help you categorize and organize your resources.
|
JobTimeout |
getTimeout()
The timeout configuration for this SubmitJob operation.
|
int |
hashCode() |
Boolean |
isPropagateTags()
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
|
void |
setArrayProperties(ArrayProperties arrayProperties)
The array properties for the submitted job, such as the size of the array.
|
void |
setContainerOverrides(ContainerOverrides containerOverrides)
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive.
|
void |
setDependsOn(Collection<JobDependency> dependsOn)
A list of dependencies for the job.
|
void |
setJobDefinition(String jobDefinition)
The job definition used by this job.
|
void |
setJobName(String jobName)
The name of the job.
|
void |
setJobQueue(String jobQueue)
The job queue where the job is submitted.
|
void |
setNodeOverrides(NodeOverrides nodeOverrides)
A list of node overrides in JSON format that specify the node range to target and the container overrides for
that node range.
|
void |
setParameters(Map<String,String> parameters)
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition.
|
void |
setPropagateTags(Boolean propagateTags)
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
|
void |
setRetryStrategy(RetryStrategy retryStrategy)
The retry strategy to use for failed jobs from this SubmitJob operation.
|
void |
setTags(Map<String,String> tags)
The tags that you apply to the job request to help you categorize and organize your resources.
|
void |
setTimeout(JobTimeout timeout)
The timeout configuration for this SubmitJob operation.
|
String |
toString()
Returns a string representation of this object.
|
SubmitJobRequest |
withArrayProperties(ArrayProperties arrayProperties)
The array properties for the submitted job, such as the size of the array.
|
SubmitJobRequest |
withContainerOverrides(ContainerOverrides containerOverrides)
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive.
|
SubmitJobRequest |
withDependsOn(Collection<JobDependency> dependsOn)
A list of dependencies for the job.
|
SubmitJobRequest |
withDependsOn(JobDependency... dependsOn)
A list of dependencies for the job.
|
SubmitJobRequest |
withJobDefinition(String jobDefinition)
The job definition used by this job.
|
SubmitJobRequest |
withJobName(String jobName)
The name of the job.
|
SubmitJobRequest |
withJobQueue(String jobQueue)
The job queue where the job is submitted.
|
SubmitJobRequest |
withNodeOverrides(NodeOverrides nodeOverrides)
A list of node overrides in JSON format that specify the node range to target and the container overrides for
that node range.
|
SubmitJobRequest |
withParameters(Map<String,String> parameters)
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition.
|
SubmitJobRequest |
withPropagateTags(Boolean propagateTags)
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task.
|
SubmitJobRequest |
withRetryStrategy(RetryStrategy retryStrategy)
The retry strategy to use for failed jobs from this SubmitJob operation.
|
SubmitJobRequest |
withTags(Map<String,String> tags)
The tags that you apply to the job request to help you categorize and organize your resources.
|
SubmitJobRequest |
withTimeout(JobTimeout timeout)
The timeout configuration for this SubmitJob operation.
|
addHandlerContext, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getHandlerContext, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestCredentialsProvider, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout
public void setJobName(String jobName)
The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.
jobName
- The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and
lowercase), numbers, hyphens, and underscores are allowed.public String getJobName()
The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.
public SubmitJobRequest withJobName(String jobName)
The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.
jobName
- The name of the job. The first character must be alphanumeric, and up to 128 letters (uppercase and
lowercase), numbers, hyphens, and underscores are allowed.public void setJobQueue(String jobQueue)
The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.
jobQueue
- The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name
(ARN) of the queue.public String getJobQueue()
The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.
public SubmitJobRequest withJobQueue(String jobQueue)
The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.
jobQueue
- The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name
(ARN) of the queue.public void setArrayProperties(ArrayProperties arrayProperties)
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see Array Jobs in the AWS Batch User Guide.
arrayProperties
- The array properties for the submitted job, such as the size of the array. The array size can be between 2
and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see
Array Jobs in the AWS
Batch User Guide.public ArrayProperties getArrayProperties()
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see Array Jobs in the AWS Batch User Guide.
public SubmitJobRequest withArrayProperties(ArrayProperties arrayProperties)
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see Array Jobs in the AWS Batch User Guide.
arrayProperties
- The array properties for the submitted job, such as the size of the array. The array size can be between 2
and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see
Array Jobs in the AWS
Batch User Guide.public List<JobDependency> getDependsOn()
A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child array job
completes sequentially, starting at index 0. You can also specify an N_TO_N
type dependency with a
job ID for array jobs. In that case, each index child of this job must wait for the corresponding index child of
each dependency to complete before it can begin.
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child
array job completes sequentially, starting at index 0. You can also specify an N_TO_N
type
dependency with a job ID for array jobs. In that case, each index child of this job must wait for the
corresponding index child of each dependency to complete before it can begin.public void setDependsOn(Collection<JobDependency> dependsOn)
A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child array job
completes sequentially, starting at index 0. You can also specify an N_TO_N
type dependency with a
job ID for array jobs. In that case, each index child of this job must wait for the corresponding index child of
each dependency to complete before it can begin.
dependsOn
- A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child
array job completes sequentially, starting at index 0. You can also specify an N_TO_N
type
dependency with a job ID for array jobs. In that case, each index child of this job must wait for the
corresponding index child of each dependency to complete before it can begin.public SubmitJobRequest withDependsOn(JobDependency... dependsOn)
A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child array job
completes sequentially, starting at index 0. You can also specify an N_TO_N
type dependency with a
job ID for array jobs. In that case, each index child of this job must wait for the corresponding index child of
each dependency to complete before it can begin.
NOTE: This method appends the values to the existing list (if any). Use
setDependsOn(java.util.Collection)
or withDependsOn(java.util.Collection)
if you want to
override the existing values.
dependsOn
- A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child
array job completes sequentially, starting at index 0. You can also specify an N_TO_N
type
dependency with a job ID for array jobs. In that case, each index child of this job must wait for the
corresponding index child of each dependency to complete before it can begin.public SubmitJobRequest withDependsOn(Collection<JobDependency> dependsOn)
A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child array job
completes sequentially, starting at index 0. You can also specify an N_TO_N
type dependency with a
job ID for array jobs. In that case, each index child of this job must wait for the corresponding index child of
each dependency to complete before it can begin.
dependsOn
- A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a
SEQUENTIAL
type dependency without specifying a job ID for array jobs so that each child
array job completes sequentially, starting at index 0. You can also specify an N_TO_N
type
dependency with a job ID for array jobs. In that case, each index child of this job must wait for the
corresponding index child of each dependency to complete before it can begin.public void setJobDefinition(String jobDefinition)
The job definition used by this job. This value can be one of name
, name:revision
, or
the Amazon Resource Name (ARN) for the job definition. If name
is specified without a revision then
the latest active revision is used.
jobDefinition
- The job definition used by this job. This value can be one of name
,
name:revision
, or the Amazon Resource Name (ARN) for the job definition. If name
is specified without a revision then the latest active revision is used.public String getJobDefinition()
The job definition used by this job. This value can be one of name
, name:revision
, or
the Amazon Resource Name (ARN) for the job definition. If name
is specified without a revision then
the latest active revision is used.
name
,
name:revision
, or the Amazon Resource Name (ARN) for the job definition. If
name
is specified without a revision then the latest active revision is used.public SubmitJobRequest withJobDefinition(String jobDefinition)
The job definition used by this job. This value can be one of name
, name:revision
, or
the Amazon Resource Name (ARN) for the job definition. If name
is specified without a revision then
the latest active revision is used.
jobDefinition
- The job definition used by this job. This value can be one of name
,
name:revision
, or the Amazon Resource Name (ARN) for the job definition. If name
is specified without a revision then the latest active revision is used.public Map<String,String> getParameters()
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition. Parameters are specified as a key and value pair mapping. Parameters in a SubmitJob
request override any corresponding parameter defaults from the job definition.
SubmitJob
request override any corresponding parameter defaults from the job definition.public void setParameters(Map<String,String> parameters)
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition. Parameters are specified as a key and value pair mapping. Parameters in a SubmitJob
request override any corresponding parameter defaults from the job definition.
parameters
- Additional parameters passed to the job that replace parameter substitution placeholders that are set in
the job definition. Parameters are specified as a key and value pair mapping. Parameters in a
SubmitJob
request override any corresponding parameter defaults from the job definition.public SubmitJobRequest withParameters(Map<String,String> parameters)
Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job
definition. Parameters are specified as a key and value pair mapping. Parameters in a SubmitJob
request override any corresponding parameter defaults from the job definition.
parameters
- Additional parameters passed to the job that replace parameter substitution placeholders that are set in
the job definition. Parameters are specified as a key and value pair mapping. Parameters in a
SubmitJob
request override any corresponding parameter defaults from the job definition.public SubmitJobRequest addParametersEntry(String key, String value)
public SubmitJobRequest clearParametersEntries()
public void setContainerOverrides(ContainerOverrides containerOverrides)
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive. You can override the default command for a container, which is
specified in the job definition or the Docker image, with a command
override. You can also override
existing environment variables on a container or add new environment variables to it with an
environment
override.
containerOverrides
- A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive. You can override the default command for a container,
which is specified in the job definition or the Docker image, with a command
override. You
can also override existing environment variables on a container or add new environment variables to it
with an environment
override.public ContainerOverrides getContainerOverrides()
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive. You can override the default command for a container, which is
specified in the job definition or the Docker image, with a command
override. You can also override
existing environment variables on a container or add new environment variables to it with an
environment
override.
command
override. You
can also override existing environment variables on a container or add new environment variables to it
with an environment
override.public SubmitJobRequest withContainerOverrides(ContainerOverrides containerOverrides)
A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive. You can override the default command for a container, which is
specified in the job definition or the Docker image, with a command
override. You can also override
existing environment variables on a container or add new environment variables to it with an
environment
override.
containerOverrides
- A list of container overrides in the JSON format that specify the name of a container in the specified job
definition and the overrides it should receive. You can override the default command for a container,
which is specified in the job definition or the Docker image, with a command
override. You
can also override existing environment variables on a container or add new environment variables to it
with an environment
override.public void setNodeOverrides(NodeOverrides nodeOverrides)
A list of node overrides in JSON format that specify the node range to target and the container overrides for that node range.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
nodeOverrides
- A list of node overrides in JSON format that specify the node range to target and the container overrides
for that node range.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
public NodeOverrides getNodeOverrides()
A list of node overrides in JSON format that specify the node range to target and the container overrides for that node range.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
public SubmitJobRequest withNodeOverrides(NodeOverrides nodeOverrides)
A list of node overrides in JSON format that specify the node range to target and the container overrides for that node range.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
nodeOverrides
- A list of node overrides in JSON format that specify the node range to target and the container overrides
for that node range.
This parameter isn't applicable to jobs running on Fargate resources; use containerOverrides
instead.
public void setRetryStrategy(RetryStrategy retryStrategy)
The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is specified here, it overrides the retry strategy defined in the job definition.
retryStrategy
- The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is
specified here, it overrides the retry strategy defined in the job definition.public RetryStrategy getRetryStrategy()
The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is specified here, it overrides the retry strategy defined in the job definition.
public SubmitJobRequest withRetryStrategy(RetryStrategy retryStrategy)
The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is specified here, it overrides the retry strategy defined in the job definition.
retryStrategy
- The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is
specified here, it overrides the retry strategy defined in the job definition.public void setPropagateTags(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. When
specified, this overrides the tag propagation setting in the job definition.
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. When specified, this overrides the tag propagation setting in the job
definition.public Boolean getPropagateTags()
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. When
specified, this overrides the tag propagation setting in the job definition.
FAILED
state. When specified, this overrides the tag propagation setting in the job
definition.public SubmitJobRequest withPropagateTags(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. When
specified, this overrides the tag propagation setting in the job definition.
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. When specified, this overrides the tag propagation setting in the job
definition.public Boolean isPropagateTags()
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. When
specified, this overrides the tag propagation setting in the job definition.
FAILED
state. When specified, this overrides the tag propagation setting in the job
definition.public void setTimeout(JobTimeout timeout)
The timeout configuration for this SubmitJob operation. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout configuration specified in the job definition. For array jobs, child jobs have the same timeout configuration as the parent job. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide.
timeout
- The timeout configuration for this SubmitJob operation. You can specify a timeout duration after
which AWS Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it
isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout
configuration specified in the job definition. For array jobs, child jobs have the same timeout
configuration as the parent job. For more information, see Job Timeouts in
the Amazon Elastic Container Service Developer Guide.public JobTimeout getTimeout()
The timeout configuration for this SubmitJob operation. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout configuration specified in the job definition. For array jobs, child jobs have the same timeout configuration as the parent job. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide.
public SubmitJobRequest withTimeout(JobTimeout timeout)
The timeout configuration for this SubmitJob operation. You can specify a timeout duration after which AWS Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout configuration specified in the job definition. For array jobs, child jobs have the same timeout configuration as the parent job. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide.
timeout
- The timeout configuration for this SubmitJob operation. You can specify a timeout duration after
which AWS Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it
isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout
configuration specified in the job definition. For array jobs, child jobs have the same timeout
configuration as the parent job. For more information, see Job Timeouts in
the Amazon Elastic Container Service Developer Guide.public Map<String,String> getTags()
The tags that you apply to the job request to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS General Reference.
public void setTags(Map<String,String> tags)
The tags that you apply to the job request to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS General Reference.
tags
- The tags that you apply to the job request to help you categorize and organize your resources. Each tag
consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS
General Reference.public SubmitJobRequest withTags(Map<String,String> tags)
The tags that you apply to the job request to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS General Reference.
tags
- The tags that you apply to the job request to help you categorize and organize your resources. Each tag
consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS
General Reference.public SubmitJobRequest addTagsEntry(String key, String value)
public SubmitJobRequest clearTagsEntries()
public String toString()
toString
in class Object
Object.toString()
public SubmitJobRequest clone()
AmazonWebServiceRequest
clone
in class AmazonWebServiceRequest
Object.clone()