Skip to main content

ECS Task

An Amazon ECS Task represents an instance of a running task. A task is the instantiation of the task definition within a cluster. Each task runs a Docker container that is defined through an ECS task definition. The tasks can either run on an EC2 instance or on AWS Fargate, a serverless compute engine for containers. For more information, please refer to the official Amazon ECS documentation.

Supported Methods​

  • GET: Get an ECS task by ID
  • LIST: List all ECS tasks
  • SEARCH: Search for ECS tasks by cluster

ecs-cluster​

An ECS task is deployed within an ECS cluster. Clusters provide the logical grouping for running your tasks on both managed (AWS Fargate) and self-managed (EC2) infrastructure.

ecs-container-instance​

An ECS task can be run on an ECS container instance when using EC2 launch type. The container instance is an EC2 instance that is registered with an ECS cluster and runs the task.

ecs-task-definition​

An ECS task is created based on a task definition. The task definition specifies the container configuration, and a task can be considered as an instantiation of this definition.

ec2-network-interface​

An ECS task may be associated with one or more EC2 network interfaces if it runs on an ECS container instance type EC2 or uses awsvpc network mode.

ip​

An ECS task is assigned an IP address, either from the host if using bridge or host network mode, or from the VPC network when using awsvpc network mode. This IP address is important for communication over the network.