Skip to main content
Version: Next

task_definition

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

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html

Columns

container_definitions: container_definition[]

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

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definitions

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.

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_size

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.

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html

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.

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html

region: string

Region for the ECS service

Optional revision: number

Revision number to combine with the family parameter

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html

Optional status: task_definition_status

If the task is currently active or not

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html

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.

See

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html