public static interface Task.Builder extends SdkPojo, CopyableBuilder<Task.Builder,Task>
| Modifier and Type | Method and Description |
|---|---|
Task.Builder |
attachments(Attachment... attachments)
The Elastic Network Adapter that's associated with the task if the task uses the
awsvpc network
mode. |
Task.Builder |
attachments(Collection<Attachment> attachments)
The Elastic Network Adapter that's associated with the task if the task uses the
awsvpc network
mode. |
Task.Builder |
attachments(Consumer<Attachment.Builder>... attachments)
The Elastic Network Adapter that's associated with the task if the task uses the
awsvpc network
mode. |
Task.Builder |
attributes(Attribute... attributes)
The attributes of the task
|
Task.Builder |
attributes(Collection<Attribute> attributes)
The attributes of the task
|
Task.Builder |
attributes(Consumer<Attribute.Builder>... attributes)
The attributes of the task
|
Task.Builder |
availabilityZone(String availabilityZone)
The Availability Zone for the task.
|
Task.Builder |
capacityProviderName(String capacityProviderName)
The capacity provider that's associated with the task.
|
Task.Builder |
clusterArn(String clusterArn)
The ARN of the cluster that hosts the task.
|
Task.Builder |
connectivity(Connectivity connectivity)
The connectivity status of a task.
|
Task.Builder |
connectivity(String connectivity)
The connectivity status of a task.
|
Task.Builder |
connectivityAt(Instant connectivityAt)
The Unix timestamp for the time when the task last went into
CONNECTED status. |
Task.Builder |
containerInstanceArn(String containerInstanceArn)
The ARN of the container instances that host the task.
|
Task.Builder |
containers(Collection<Container> containers)
The containers that's associated with the task.
|
Task.Builder |
containers(Consumer<Container.Builder>... containers)
The containers that's associated with the task.
|
Task.Builder |
containers(Container... containers)
The containers that's associated with the task.
|
Task.Builder |
cpu(String cpu)
The number of CPU units used by the task as expressed in a task definition.
|
Task.Builder |
createdAt(Instant createdAt)
The Unix timestamp for the time when the task was created.
|
Task.Builder |
desiredStatus(String desiredStatus)
The desired status of the task.
|
Task.Builder |
enableExecuteCommand(Boolean enableExecuteCommand)
Determines whether execute command functionality is enabled for this task.
|
default Task.Builder |
ephemeralStorage(Consumer<EphemeralStorage.Builder> ephemeralStorage)
The ephemeral storage settings for the task.
|
Task.Builder |
ephemeralStorage(EphemeralStorage ephemeralStorage)
The ephemeral storage settings for the task.
|
Task.Builder |
executionStoppedAt(Instant executionStoppedAt)
The Unix timestamp for the time when the task execution stopped.
|
Task.Builder |
group(String group)
The name of the task group that's associated with the task.
|
Task.Builder |
healthStatus(HealthStatus healthStatus)
The health status for the task.
|
Task.Builder |
healthStatus(String healthStatus)
The health status for the task.
|
Task.Builder |
inferenceAccelerators(Collection<InferenceAccelerator> inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
|
Task.Builder |
inferenceAccelerators(Consumer<InferenceAccelerator.Builder>... inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
|
Task.Builder |
inferenceAccelerators(InferenceAccelerator... inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
|
Task.Builder |
lastStatus(String lastStatus)
The last known status for the task.
|
Task.Builder |
launchType(LaunchType launchType)
The infrastructure where your task runs on.
|
Task.Builder |
launchType(String launchType)
The infrastructure where your task runs on.
|
Task.Builder |
memory(String memory)
The amount of memory (in MiB) that the task uses as expressed in a task definition.
|
default Task.Builder |
overrides(Consumer<TaskOverride.Builder> overrides)
One or more container overrides.
|
Task.Builder |
overrides(TaskOverride overrides)
One or more container overrides.
|
Task.Builder |
platformFamily(String platformFamily)
The operating system that your tasks are running on.
|
Task.Builder |
platformVersion(String platformVersion)
The platform version where your task runs on.
|
Task.Builder |
pullStartedAt(Instant pullStartedAt)
The Unix timestamp for the time when the container image pull began.
|
Task.Builder |
pullStoppedAt(Instant pullStoppedAt)
The Unix timestamp for the time when the container image pull completed.
|
Task.Builder |
startedAt(Instant startedAt)
The Unix timestamp for the time when the task started.
|
Task.Builder |
startedBy(String startedBy)
The tag specified when a task is started.
|
Task.Builder |
stopCode(String stopCode)
The stop code indicating why a task was stopped.
|
Task.Builder |
stopCode(TaskStopCode stopCode)
The stop code indicating why a task was stopped.
|
Task.Builder |
stoppedAt(Instant stoppedAt)
The Unix timestamp for the time when the task was stopped.
|
Task.Builder |
stoppedReason(String stoppedReason)
The reason that the task was stopped.
|
Task.Builder |
stoppingAt(Instant stoppingAt)
The Unix timestamp for the time when the task stops.
|
Task.Builder |
tags(Collection<Tag> tags)
The metadata that you apply to the task to help you categorize and organize the task.
|
Task.Builder |
tags(Consumer<Tag.Builder>... tags)
The metadata that you apply to the task to help you categorize and organize the task.
|
Task.Builder |
tags(Tag... tags)
The metadata that you apply to the task to help you categorize and organize the task.
|
Task.Builder |
taskArn(String taskArn)
The Amazon Resource Name (ARN) of the task.
|
Task.Builder |
taskDefinitionArn(String taskDefinitionArn)
The ARN of the task definition that creates the task.
|
Task.Builder |
version(Long version)
The version counter for the task.
|
equalsBySdkFields, sdkFieldscopyapplyMutation, buildTask.Builder attachments(Collection<Attachment> attachments)
The Elastic Network Adapter that's associated with the task if the task uses the awsvpc network
mode.
attachments - The Elastic Network Adapter that's associated with the task if the task uses the awsvpc
network mode.Task.Builder attachments(Attachment... attachments)
The Elastic Network Adapter that's associated with the task if the task uses the awsvpc network
mode.
attachments - The Elastic Network Adapter that's associated with the task if the task uses the awsvpc
network mode.Task.Builder attachments(Consumer<Attachment.Builder>... attachments)
The Elastic Network Adapter that's associated with the task if the task uses the awsvpc network
mode.
Attachment.Builder avoiding the need to create one manually
via Attachment.builder().
When the Consumer completes,
SdkBuilder.build() is called immediately and its
result is passed to #attachments(List.
attachments - a consumer that will call methods on
Attachment.Builder#attachments(java.util.Collection) Task.Builder attributes(Collection<Attribute> attributes)
The attributes of the task
attributes - The attributes of the taskTask.Builder attributes(Attribute... attributes)
The attributes of the task
attributes - The attributes of the taskTask.Builder attributes(Consumer<Attribute.Builder>... attributes)
The attributes of the task
This is a convenience method that creates an instance of theAttribute.Builder avoiding the need to create one manually
via Attribute.builder().
When the Consumer completes,
SdkBuilder.build() is called immediately and its
result is passed to #attributes(List.
attributes - a consumer that will call methods on
Attribute.Builder#attributes(java.util.Collection) Task.Builder availabilityZone(String availabilityZone)
The Availability Zone for the task.
availabilityZone - The Availability Zone for the task.Task.Builder capacityProviderName(String capacityProviderName)
The capacity provider that's associated with the task.
capacityProviderName - The capacity provider that's associated with the task.Task.Builder clusterArn(String clusterArn)
The ARN of the cluster that hosts the task.
clusterArn - The ARN of the cluster that hosts the task.Task.Builder connectivity(String connectivity)
The connectivity status of a task.
connectivity - The connectivity status of a task.Connectivity,
ConnectivityTask.Builder connectivity(Connectivity connectivity)
The connectivity status of a task.
connectivity - The connectivity status of a task.Connectivity,
ConnectivityTask.Builder connectivityAt(Instant connectivityAt)
The Unix timestamp for the time when the task last went into CONNECTED status.
connectivityAt - The Unix timestamp for the time when the task last went into CONNECTED status.Task.Builder containerInstanceArn(String containerInstanceArn)
The ARN of the container instances that host the task.
containerInstanceArn - The ARN of the container instances that host the task.Task.Builder containers(Collection<Container> containers)
The containers that's associated with the task.
containers - The containers that's associated with the task.Task.Builder containers(Container... containers)
The containers that's associated with the task.
containers - The containers that's associated with the task.Task.Builder containers(Consumer<Container.Builder>... containers)
The containers that's associated with the task.
This is a convenience method that creates an instance of theContainer.Builder avoiding the need to create one manually
via Container.builder().
When the Consumer completes,
SdkBuilder.build() is called immediately and its
result is passed to #containers(List.
containers - a consumer that will call methods on
Container.Builder#containers(java.util.Collection) Task.Builder cpu(String cpu)
The number of CPU units used by the task as expressed in a task definition. It can be expressed as an integer
using CPU units (for example, 1024). It can also be expressed as a string using vCPUs (for
example, 1 vCPU or 1 vcpu). String values are converted to an integer that
indicates the CPU units when the task definition is registered.
If you use the EC2 launch type, this field is optional. Supported values are between 128 CPU
units (0.125 vCPUs) and 10240 CPU units (10 vCPUs).
If you use the Fargate launch type, this field is required. You must use one of the following values. These
values determine the range of supported values for the memory parameter:
The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.
256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)
512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB)
1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB),
6144 (6 GB), 7168 (7 GB), 8192 (8 GB)
2048 (2 vCPU) - Available memory values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1
GB)
4096 (4 vCPU) - Available memory values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1
GB)
8192 (8 vCPU) - Available memory values: 16 GB and 60 GB in 4 GB increments
This option requires Linux platform 1.4.0 or later.
16384 (16vCPU) - Available memory values: 32GB and 120 GB in 8 GB increments
This option requires Linux platform 1.4.0 or later.
cpu - The number of CPU units used by the task as expressed in a task definition. It can be expressed as an
integer using CPU units (for example, 1024). It can also be expressed as a string using
vCPUs (for example, 1 vCPU or 1 vcpu). String values are converted to an
integer that indicates the CPU units when the task definition is registered.
If you use the EC2 launch type, this field is optional. Supported values are between 128
CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs).
If you use the Fargate launch type, this field is required. You must use one of the following values.
These values determine the range of supported values for the memory parameter:
The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.
256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)
512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4
GB)
1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5
GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB)
2048 (2 vCPU) - Available memory values: 4096 (4 GB) and 16384 (16 GB) in increments of
1024 (1 GB)
4096 (4 vCPU) - Available memory values: 8192 (8 GB) and 30720 (30 GB) in increments of
1024 (1 GB)
8192 (8 vCPU) - Available memory values: 16 GB and 60 GB in 4 GB increments
This option requires Linux platform 1.4.0 or later.
16384 (16vCPU) - Available memory values: 32GB and 120 GB in 8 GB increments
This option requires Linux platform 1.4.0 or later.
Task.Builder createdAt(Instant createdAt)
The Unix timestamp for the time when the task was created. More specifically, it's for the time when the task
entered the PENDING state.
createdAt - The Unix timestamp for the time when the task was created. More specifically, it's for the time when
the task entered the PENDING state.Task.Builder desiredStatus(String desiredStatus)
The desired status of the task. For more information, see Task Lifecycle.
desiredStatus - The desired status of the task. For more information, see Task
Lifecycle.Task.Builder enableExecuteCommand(Boolean enableExecuteCommand)
Determines whether execute command functionality is enabled for this task. If true, execute
command functionality is enabled on all the containers in the task.
enableExecuteCommand - Determines whether execute command functionality is enabled for this task. If true,
execute command functionality is enabled on all the containers in the task.Task.Builder executionStoppedAt(Instant executionStoppedAt)
The Unix timestamp for the time when the task execution stopped.
executionStoppedAt - The Unix timestamp for the time when the task execution stopped.Task.Builder group(String group)
The name of the task group that's associated with the task.
group - The name of the task group that's associated with the task.Task.Builder healthStatus(String healthStatus)
The health status for the task. It's determined by the health of the essential containers in the task. If all
essential containers in the task are reporting as HEALTHY, the task status also reports as
HEALTHY. If any essential containers in the task are reporting as UNHEALTHY or
UNKNOWN, the task status also reports as UNHEALTHY or UNKNOWN.
The Amazon ECS container agent doesn't monitor or report on Docker health checks that are embedded in a container image and not specified in the container definition. For example, this includes those specified in a parent image or from the image's Dockerfile. Health check parameters that are specified in a container definition override any Docker health checks that are found in the container image.
healthStatus - The health status for the task. It's determined by the health of the essential containers in the task.
If all essential containers in the task are reporting as HEALTHY, the task status also
reports as HEALTHY. If any essential containers in the task are reporting as
UNHEALTHY or UNKNOWN, the task status also reports as UNHEALTHY
or UNKNOWN. The Amazon ECS container agent doesn't monitor or report on Docker health checks that are embedded in a container image and not specified in the container definition. For example, this includes those specified in a parent image or from the image's Dockerfile. Health check parameters that are specified in a container definition override any Docker health checks that are found in the container image.
HealthStatus,
HealthStatusTask.Builder healthStatus(HealthStatus healthStatus)
The health status for the task. It's determined by the health of the essential containers in the task. If all
essential containers in the task are reporting as HEALTHY, the task status also reports as
HEALTHY. If any essential containers in the task are reporting as UNHEALTHY or
UNKNOWN, the task status also reports as UNHEALTHY or UNKNOWN.
The Amazon ECS container agent doesn't monitor or report on Docker health checks that are embedded in a container image and not specified in the container definition. For example, this includes those specified in a parent image or from the image's Dockerfile. Health check parameters that are specified in a container definition override any Docker health checks that are found in the container image.
healthStatus - The health status for the task. It's determined by the health of the essential containers in the task.
If all essential containers in the task are reporting as HEALTHY, the task status also
reports as HEALTHY. If any essential containers in the task are reporting as
UNHEALTHY or UNKNOWN, the task status also reports as UNHEALTHY
or UNKNOWN. The Amazon ECS container agent doesn't monitor or report on Docker health checks that are embedded in a container image and not specified in the container definition. For example, this includes those specified in a parent image or from the image's Dockerfile. Health check parameters that are specified in a container definition override any Docker health checks that are found in the container image.
HealthStatus,
HealthStatusTask.Builder inferenceAccelerators(Collection<InferenceAccelerator> inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
inferenceAccelerators - The Elastic Inference accelerator that's associated with the task.Task.Builder inferenceAccelerators(InferenceAccelerator... inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
inferenceAccelerators - The Elastic Inference accelerator that's associated with the task.Task.Builder inferenceAccelerators(Consumer<InferenceAccelerator.Builder>... inferenceAccelerators)
The Elastic Inference accelerator that's associated with the task.
This is a convenience method that creates an instance of theInferenceAccelerator.Builder avoiding the need to create
one manually via InferenceAccelerator.builder().
When the Consumer completes,
SdkBuilder.build() is called immediately
and its result is passed to #inferenceAccelerators(List.
inferenceAccelerators - a consumer that will call methods on
InferenceAccelerator.Builder#inferenceAccelerators(java.util.Collection) Task.Builder lastStatus(String lastStatus)
The last known status for the task. For more information, see Task Lifecycle.
lastStatus - The last known status for the task. For more information, see Task
Lifecycle.Task.Builder launchType(String launchType)
The infrastructure where your task runs on. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.
launchType - The infrastructure where your task runs on. For more information, see Amazon ECS launch
types in the Amazon Elastic Container Service Developer Guide.LaunchType,
LaunchTypeTask.Builder launchType(LaunchType launchType)
The infrastructure where your task runs on. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.
launchType - The infrastructure where your task runs on. For more information, see Amazon ECS launch
types in the Amazon Elastic Container Service Developer Guide.LaunchType,
LaunchTypeTask.Builder memory(String memory)
The amount of memory (in MiB) that the task uses as expressed in a task definition. It can be expressed as an
integer using MiB (for example, 1024). If it's expressed as a string using GB (for example,
1GB or 1 GB), it's converted to an integer indicating the MiB when the task
definition is registered.
If you use the EC2 launch type, this field is optional.
If you use the Fargate launch type, this field is required. You must use one of the following values. The
value that you choose determines the range of supported values for the cpu parameter.
512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)
1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)
2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available
cpu values: 1024 (1 vCPU)
Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048
(2 vCPU)
Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096
(4 vCPU)
Between 16 GB and 60 GB in 4 GB increments - Available cpu values: 8192 (8 vCPU)
This option requires Linux platform 1.4.0 or later.
Between 32GB and 120 GB in 8 GB increments - Available cpu values: 16384 (16 vCPU)
This option requires Linux platform 1.4.0 or later.
memory - The amount of memory (in MiB) that the task uses as expressed in a task definition. It can be
expressed as an integer using MiB (for example, 1024). If it's expressed as a string
using GB (for example, 1GB or 1 GB), it's converted to an integer indicating
the MiB when the task definition is registered.
If you use the EC2 launch type, this field is optional.
If you use the Fargate launch type, this field is required. You must use one of the following values.
The value that you choose determines the range of supported values for the cpu parameter.
512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)
1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)
2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available
cpu values: 1024 (1 vCPU)
Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu
values: 2048 (2 vCPU)
Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu
values: 4096 (4 vCPU)
Between 16 GB and 60 GB in 4 GB increments - Available cpu values: 8192 (8 vCPU)
This option requires Linux platform 1.4.0 or later.
Between 32GB and 120 GB in 8 GB increments - Available cpu values: 16384 (16 vCPU)
This option requires Linux platform 1.4.0 or later.
Task.Builder overrides(TaskOverride overrides)
One or more container overrides.
overrides - One or more container overrides.default Task.Builder overrides(Consumer<TaskOverride.Builder> overrides)
One or more container overrides.
This is a convenience method that creates an instance of theTaskOverride.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.Builderoverrides(TaskOverride)Task.Builder platformVersion(String platformVersion)
The platform version where your task runs on. A platform version is only specified for tasks that use the
Fargate launch type. If you didn't specify one, the LATEST platform version is used. For more
information, see Fargate Platform
Versions in the Amazon Elastic Container Service Developer Guide.
platformVersion - The platform version where your task runs on. A platform version is only specified for tasks that use
the Fargate launch type. If you didn't specify one, the LATEST platform version is used.
For more information, see Fargate
Platform Versions in the Amazon Elastic Container Service Developer Guide.Task.Builder platformFamily(String platformFamily)
The operating system that your tasks are running on. A platform family is specified only for tasks that use the Fargate launch type.
All tasks that run as part of this service must use the same platformFamily value as the service
(for example, LINUX.).
platformFamily - The operating system that your tasks are running on. A platform family is specified only for tasks
that use the Fargate launch type.
All tasks that run as part of this service must use the same platformFamily value as the
service (for example, LINUX.).
Task.Builder pullStartedAt(Instant pullStartedAt)
The Unix timestamp for the time when the container image pull began.
pullStartedAt - The Unix timestamp for the time when the container image pull began.Task.Builder pullStoppedAt(Instant pullStoppedAt)
The Unix timestamp for the time when the container image pull completed.
pullStoppedAt - The Unix timestamp for the time when the container image pull completed.Task.Builder startedAt(Instant startedAt)
The Unix timestamp for the time when the task started. More specifically, it's for the time when the task
transitioned from the PENDING state to the RUNNING state.
startedAt - The Unix timestamp for the time when the task started. More specifically, it's for the time when the
task transitioned from the PENDING state to the RUNNING state.Task.Builder startedBy(String startedBy)
The tag specified when a task is started. If an Amazon ECS service started the task, the
startedBy parameter contains the deployment ID of that service.
startedBy - The tag specified when a task is started. If an Amazon ECS service started the task, the
startedBy parameter contains the deployment ID of that service.Task.Builder stopCode(String stopCode)
The stop code indicating why a task was stopped. The stoppedReason might contain additional
details.
The following are valid values:
TaskFailedToStart
EssentialContainerExited
UserInitiated
TerminationNotice
ServiceSchedulerInitiated
SpotInterruption
stopCode - The stop code indicating why a task was stopped. The stoppedReason might contain
additional details.
The following are valid values:
TaskFailedToStart
EssentialContainerExited
UserInitiated
TerminationNotice
ServiceSchedulerInitiated
SpotInterruption
TaskStopCode,
TaskStopCodeTask.Builder stopCode(TaskStopCode stopCode)
The stop code indicating why a task was stopped. The stoppedReason might contain additional
details.
The following are valid values:
TaskFailedToStart
EssentialContainerExited
UserInitiated
TerminationNotice
ServiceSchedulerInitiated
SpotInterruption
stopCode - The stop code indicating why a task was stopped. The stoppedReason might contain
additional details.
The following are valid values:
TaskFailedToStart
EssentialContainerExited
UserInitiated
TerminationNotice
ServiceSchedulerInitiated
SpotInterruption
TaskStopCode,
TaskStopCodeTask.Builder stoppedAt(Instant stoppedAt)
The Unix timestamp for the time when the task was stopped. More specifically, it's for the time when the task
transitioned from the RUNNING state to the STOPPED state.
stoppedAt - The Unix timestamp for the time when the task was stopped. More specifically, it's for the time when
the task transitioned from the RUNNING state to the STOPPED state.Task.Builder stoppedReason(String stoppedReason)
The reason that the task was stopped.
stoppedReason - The reason that the task was stopped.Task.Builder stoppingAt(Instant stoppingAt)
The Unix timestamp for the time when the task stops. More specifically, it's for the time when the task
transitions from the RUNNING state to STOPPED.
stoppingAt - The Unix timestamp for the time when the task stops. More specifically, it's for the time when the
task transitions from the RUNNING state to STOPPED.Task.Builder tags(Collection<Tag> tags)
The metadata that you apply to the task to help you categorize and organize the task. Each tag consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix
for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys
or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
tags - The metadata that you apply to the task to help you categorize and organize the task. Each tag
consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a
prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or
delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per
resource limit.
Task.Builder tags(Tag... tags)
The metadata that you apply to the task to help you categorize and organize the task. Each tag consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix
for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys
or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
tags - The metadata that you apply to the task to help you categorize and organize the task. Each tag
consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a
prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or
delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per
resource limit.
Task.Builder tags(Consumer<Tag.Builder>... tags)
The metadata that you apply to the task to help you categorize and organize the task. Each tag consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix
for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys
or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
Tag.Builder avoiding the need to create one manually via
Tag.builder().
When the Consumer completes, SdkBuilder.build() is
called immediately and its result is passed to #tags(List.
tags - a consumer that will call methods on Tag.Builder#tags(java.util.Collection) Task.Builder taskArn(String taskArn)
The Amazon Resource Name (ARN) of the task.
taskArn - The Amazon Resource Name (ARN) of the task.Task.Builder taskDefinitionArn(String taskDefinitionArn)
The ARN of the task definition that creates the task.
taskDefinitionArn - The ARN of the task definition that creates the task.Task.Builder version(Long version)
The version counter for the task. Every time a task experiences a change that starts a CloudWatch event, the
version counter is incremented. If you replicate your Amazon ECS task state with CloudWatch Events, you can
compare the version of a task reported by the Amazon ECS API actions with the version reported in CloudWatch
Events for the task (inside the detail object) to verify that the version in your event stream
is current.
version - The version counter for the task. Every time a task experiences a change that starts a CloudWatch
event, the version counter is incremented. If you replicate your Amazon ECS task state with CloudWatch
Events, you can compare the version of a task reported by the Amazon ECS API actions with the version
reported in CloudWatch Events for the task (inside the detail object) to verify that the
version in your event stream is current.Task.Builder ephemeralStorage(EphemeralStorage ephemeralStorage)
The ephemeral storage settings for the task.
ephemeralStorage - The ephemeral storage settings for the task.default Task.Builder ephemeralStorage(Consumer<EphemeralStorage.Builder> ephemeralStorage)
The ephemeral storage settings for the task.
This is a convenience method that creates an instance of theEphemeralStorage.Builder avoiding the
need to create one manually via EphemeralStorage.builder().
When the Consumer completes, SdkBuilder.build() is called immediately and its
result is passed to ephemeralStorage(EphemeralStorage).
ephemeralStorage - a consumer that will call methods on EphemeralStorage.BuilderephemeralStorage(EphemeralStorage)Copyright © 2022. All rights reserved.