Skip to main content
Version: Next


Table to manage AWS ECS task definitions. A task definition is required to run Docker containers in Amazon ECS.



container_definitions: container_definition[]

Reference to the container definitions that are passed to the Docker daemon on a container instance.


cpu_memory: cpu_mem_combination

When you register a task definition, you can specify the total CPU and memory used for the task. This is separate from the cpu and memory values at the container definition level.


Optional execution_role: iam_role

The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make AWS API calls on your behalf. The task execution IAM role is required depending on the requirements of your task.


family: string

When you register a task definition, you give it a family, which is similar to a name for multiple versions of the task definition, specified with a revision number. The first task definition that's registered into a particular family is given a revision of 1, and any task definitions registered after that are given a sequential revision number.


region: string

Region for the ECS service

Optional revision: number

Revision number to combine with the family parameter


Optional status: task_definition_status

If the task is currently active or not


Optional task_role: iam_role

When you register a task definition, you can provide a task role for an IAM role that allows the containers in the task permission to call the AWS APIs that are specified in its associated policies on your behalf.