ecs:RegisterTaskDefinition

Write

ecs:RegisterTaskDefinition is a Write access-level action in the ecs service. Grants permission to register a new task definition from the supplied family and containerDefinitions

Resource types

ARNs that ecs:RegisterTaskDefinition can be scoped to in an IAM policy.

arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} required
task-definition

Condition keys

Keys you can use in the Condition block of a policy that grants ecs:RegisterTaskDefinition.

aws:RequestTag/${TagKey} String

Filters access by the tags that are passed in the request

aws:TagKeys ArrayOfString

Filters access by the tag keys that are passed in the request

ecs:compute-compatibility ArrayOfString

Filters access by the required compatibilities field provided in the request

ecs:privileged String

Filters access by the privileged field provided in the request

ecs:task-cpu Numeric

Filters access by the task cpu, as an integer with 1024 = 1 vCPU, provided in the request

ecs:task-memory Numeric

Filters access by the task memory, as an integer representing MiB, provided in the request

aws:ResourceTag/${TagKey} String

Filters access by the tag key-value pairs attached to the resource

Example IAM policy

A minimal policy that allows ecs:RegisterTaskDefinition. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEcsRegisterTaskDefinition",
      "Effect": "Allow",
      "Action": "ecs:RegisterTaskDefinition",
      "Resource": "*"
    }
  ]
}

Related actions in ecs

View all ecs actions →