public static interface StartTaskRequest.Builder extends EcsRequest.Builder, CopyableBuilder<StartTaskRequest.Builder,StartTaskRequest>
Modifier and Type | Method and Description |
---|---|
StartTaskRequest.Builder |
cluster(String cluster)
The short name or full Amazon Resource Name (ARN) of the cluster on which to start your task.
|
StartTaskRequest.Builder |
containerInstances(Collection<String> containerInstances)
The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on which
you would like to place your task.
|
StartTaskRequest.Builder |
containerInstances(String... containerInstances)
The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on which
you would like to place your task.
|
StartTaskRequest.Builder |
group(String group)
The name of the task group to associate with the task.
|
default StartTaskRequest.Builder |
networkConfiguration(Consumer<NetworkConfiguration.Builder> networkConfiguration)
The VPC subnet and security group configuration for tasks that receive their own Elastic Network Interface by
using the
awsvpc networking mode. |
StartTaskRequest.Builder |
networkConfiguration(NetworkConfiguration networkConfiguration)
The VPC subnet and security group configuration for tasks that receive their own Elastic Network Interface by
using the
awsvpc networking mode. |
StartTaskRequest.Builder |
overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)
Add an optional request override configuration.
|
StartTaskRequest.Builder |
overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)
Add an optional request override configuration.
|
default StartTaskRequest.Builder |
overrides(Consumer<TaskOverride.Builder> overrides)
A list of container overrides in JSON format that specify the name of a container in the specified task
definition and the overrides it should receive.
|
StartTaskRequest.Builder |
overrides(TaskOverride overrides)
A list of container overrides in JSON format that specify the name of a container in the specified task
definition and the overrides it should receive.
|
StartTaskRequest.Builder |
startedBy(String startedBy)
An optional tag specified when a task is started.
|
StartTaskRequest.Builder |
taskDefinition(String taskDefinition)
The
family and revision (family:revision ) or full Amazon Resource Name
(ARN) of the task definition to start. |
build
overrideConfiguration
copy
applyMutation, build
StartTaskRequest.Builder cluster(String cluster)
The short name or full Amazon Resource Name (ARN) of the cluster on which to start your task. If you do not specify a cluster, the default cluster is assumed.
cluster
- The short name or full Amazon Resource Name (ARN) of the cluster on which to start your task. If you
do not specify a cluster, the default cluster is assumed.StartTaskRequest.Builder taskDefinition(String taskDefinition)
The family
and revision
(family:revision
) or full Amazon Resource Name
(ARN) of the task definition to start. If a revision
is not specified, the latest
ACTIVE
revision is used.
taskDefinition
- The family
and revision
(family:revision
) or full Amazon
Resource Name (ARN) of the task definition to start. If a revision
is not specified, the
latest ACTIVE
revision is used.StartTaskRequest.Builder overrides(TaskOverride overrides)
A list of container overrides in JSON format that specify the name of a container in the specified task
definition and the overrides it should receive. You can override the default command for a container (that is
specified in the task definition or Docker image) with a command
override. You can also override
existing environment variables (that are specified in the task definition or Docker image) on a container or
add new environment variables to it with an environment
override.
A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.
overrides
- A list of container overrides in JSON format that specify the name of a container in the specified
task definition and the overrides it should receive. You can override the default command for a
container (that is specified in the task definition or Docker image) with a command
override. You can also override existing environment variables (that are specified in the task
definition or Docker image) on a container or add new environment variables to it with an
environment
override. A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.
default StartTaskRequest.Builder overrides(Consumer<TaskOverride.Builder> overrides)
A list of container overrides in JSON format that specify the name of a container in the specified task
definition and the overrides it should receive. You can override the default command for a container (that is
specified in the task definition or Docker image) with a command
override. You can also override
existing environment variables (that are specified in the task definition or Docker image) on a container or
add new environment variables to it with an environment
override.
A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.
TaskOverride.Builder
avoiding the need
to create one manually via TaskOverride.builder()
.
When the Consumer
completes, SdkBuilder.build()
is called immediately and its
result is passed to overrides(TaskOverride)
.overrides
- a consumer that will call methods on TaskOverride.Builder
overrides(TaskOverride)
StartTaskRequest.Builder containerInstances(Collection<String> containerInstances)
The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on which you would like to place your task. You can specify up to 10 container instances.
containerInstances
- The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on
which you would like to place your task. You can specify up to 10 container instances.StartTaskRequest.Builder containerInstances(String... containerInstances)
The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on which you would like to place your task. You can specify up to 10 container instances.
containerInstances
- The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on
which you would like to place your task. You can specify up to 10 container instances.StartTaskRequest.Builder startedBy(String startedBy)
An optional tag specified when a task is started. For example if you automatically trigger a task to run a
batch process job, you could apply a unique identifier for that job to your task with the
startedBy
parameter. You can then identify which tasks belong to that job by filtering the
results of a ListTasks call with the startedBy
value. Up to 36 letters (uppercase and
lowercase), numbers, hyphens, and underscores are allowed.
If a task is started by an Amazon ECS service, then the startedBy
parameter contains the
deployment ID of the service that starts it.
startedBy
- An optional tag specified when a task is started. For example if you automatically trigger a task to
run a batch process job, you could apply a unique identifier for that job to your task with the
startedBy
parameter. You can then identify which tasks belong to that job by filtering
the results of a ListTasks call with the startedBy
value. Up to 36 letters
(uppercase and lowercase), numbers, hyphens, and underscores are allowed.
If a task is started by an Amazon ECS service, then the startedBy
parameter contains the
deployment ID of the service that starts it.
StartTaskRequest.Builder group(String group)
The name of the task group to associate with the task. The default value is the family name of the task definition (for example, family:my-family-name).
group
- The name of the task group to associate with the task. The default value is the family name of the
task definition (for example, family:my-family-name).StartTaskRequest.Builder networkConfiguration(NetworkConfiguration networkConfiguration)
The VPC subnet and security group configuration for tasks that receive their own Elastic Network Interface by
using the awsvpc
networking mode.
networkConfiguration
- The VPC subnet and security group configuration for tasks that receive their own Elastic Network
Interface by using the awsvpc
networking mode.default StartTaskRequest.Builder networkConfiguration(Consumer<NetworkConfiguration.Builder> networkConfiguration)
The VPC subnet and security group configuration for tasks that receive their own Elastic Network Interface by
using the awsvpc
networking mode.
NetworkConfiguration.Builder
avoiding the need
to create one manually via NetworkConfiguration.builder()
.
When the Consumer
completes, SdkBuilder.build()
is called immediately and
its result is passed to networkConfiguration(NetworkConfiguration)
.networkConfiguration
- a consumer that will call methods on NetworkConfiguration.Builder
networkConfiguration(NetworkConfiguration)
StartTaskRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)
AwsRequest.Builder
overrideConfiguration
in interface AwsRequest.Builder
overrideConfiguration
- The override configuration.StartTaskRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)
AwsRequest.Builder
overrideConfiguration
in interface AwsRequest.Builder
builderConsumer
- A Consumer
to which an empty AwsRequestOverrideConfiguration.Builder
will be
given.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.