An attribute is a name-value pair associated with an Amazon ECS object.
Attributes enable you to extend the Amazon ECS data model by adding custom
metadata to your resources. For more information, see Attributes
in the Amazon Elastic Container Service Developer Guide.
A regional grouping of one or more container instances on which you can run
task requests. Each account receives a default cluster the first time you
use the Amazon ECS service, but you may also create other clusters. Clusters
may contain more than one instance type simultaneously.
The dependencies defined for container startup and shutdown. A container can
contain multiple dependencies. When a dependency is defined for container
startup, for container shutdown it is reversed.
The overrides that should be sent to a container. An empty container
override can be passed in. An example of an empty container override would
be {"containerOverrides": }. If a non-empty container
override is specified, the name parameter must be included.
The deployment controller to use for the service. For more information, see
Amazon
ECS Deployment Types in the Amazon Elastic Container Service
Developer Guide.
This parameter is specified when you are using Docker volumes. Docker
volumes are only supported when you are using the EC2 launch type. Windows
containers only support the use of the local driver. To use
bind mounts, specify a host instead.
Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast,
container management service that makes it easy to run, stop, and manage
Docker containers on a cluster. You can host your cluster on a serverless
infrastructure that is managed by Amazon ECS by launching your services or
tasks using the Fargate launch type. For more control, you can host your
tasks on a cluster of Amazon Elastic Compute Cloud (Amazon EC2) instances
that you manage by using the EC2 launch type. For more information about
launch types, see Amazon
ECS Launch Types.
This parameter is specified when you are using an Amazon Elastic File System
file system for task storage. For more information, see Amazon
EFS Volumes in the Amazon Elastic Container Service Developer
Guide.
A list of files containing the environment variables to pass to a container.
You can specify up to ten environment files. The file must have a
.env file extension. Each line in an environment file should
contain an environment variable in VARIABLE=VALUE format. Lines
beginning with # are treated as comments and are ignored. For
more information on the environment variable file syntax, see Declare default environment
variables in file.
The FireLens configuration for the container. This is used to specify and
configure a log router for container logs. For more information, see Custom
Log Routing in the Amazon Elastic Container Service Developer
Guide.
The authorization configuration details for Amazon FSx for Windows File
Server file system. See FSxWindowsFileServerVolumeConfiguration
in the Amazon Elastic Container Service API Reference.
An object representing a container health check. Health check parameters
that are specified in a container definition override any Docker health
checks that exist in the container image (such as those specified in a
parent image or from the image's Dockerfile).
Details on an Elastic Inference accelerator task override. This parameter is
used to override the Elastic Inference accelerator specified in the task
definition. For more information, see Working
with Amazon Elastic Inference on Amazon ECS in the Amazon Elastic
Container Service Developer Guide.
The Linux capabilities for the container that are added to or dropped from
the default configuration provided by Docker. For more information on the
default capabilities and the non-default available capabilities, see Runtime
privilege and Linux capabilities in the Docker run reference. For
more detailed information on these Linux capabilities, see the capabilities(7)
Linux manual page.
Details on the network bindings between a container and its host container
instance. After a task reaches the RUNNING status, manual and
automatic host and container port assignments are visible in the
networkBindings section of DescribeTasks API responses.
An object representing a constraint on task placement. For more information,
see Task
Placement Constraints in the Amazon Elastic Container Service
Developer Guide.
The task placement strategy for a task or service. For more information, see
Task
Placement Strategies in the Amazon Elastic Container Service
Developer Guide.
Port mappings allow containers to access ports on the host container
instance to send or receive traffic. Port mappings are specified as part of
the container definition.
A list of namespaced kernel parameters to set in the container. This
parameter maps to Sysctls in the Create
a container section of the Docker Remote API and
the --sysctl option to docker
run.
The metadata that you apply to a resource to help you categorize and
organize them. Each tag consists of a key and an optional value, both of
which you define.
The details of a task definition which describes the container and volume
definitions of an Amazon Elastic Container Service task. You can specify
which Docker images to use, the required resources, and other configurations
related to launching the task definition through an Amazon ECS service or
task.
An object representing a constraint on task placement in the task
definition. For more information, see Task
Placement Constraints in the Amazon Elastic Container Service
Developer Guide.
Information about a set of Amazon ECS tasks in either an AWS CodeDeploy or
an EXTERNAL deployment. An Amazon ECS task set includes details
such as the desired number of tasks, how many tasks are running, and whether
the task set serves production traffic.
A data volume used in a task definition. For tasks that use the Amazon
Elastic File System (Amazon EFS), specify an
efsVolumeConfiguration. For Windows tasks that use Amazon FSx
for Windows File Server file system, specify a
fsxWindowsFileServerVolumeConfiguration. For tasks that use a
Docker volume, specify a DockerVolumeConfiguration. For tasks
that use a bind mount host volume, specify a host and optional
sourcePath. For more information, see Using
Data Volumes in Tasks.
