ecs:RunTask

Write

ecs:RunTask is a Write access-level action in the ecs service. Grants permission to start a task using random placement and the default Amazon ECS scheduler

Resource types

ARNs that ecs:RunTask 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:RunTask.

aws:RequestTag/${TagKey} String

Filters access by the tags that are passed in the request

aws:ResourceTag/${TagKey} String

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

aws:TagKeys ArrayOfString

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

ecs:capacity-provider ArrayOfARN

Filters access by the ARN of an Amazon ECS capacity provider

ecs:cluster ARN

Filters access by the ARN of an Amazon ECS cluster

ecs:enable-ebs-volumes String

Filters access by the Amazon ECS managed Amazon EBS volume capability of your ECS task or service

ecs:enable-execute-command String

Filters access by the execute-command capability of your Amazon ECS task or Amazon ECS service

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

ecs:ResourceTag/${TagKey} String

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

Example IAM policy

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

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

Related actions in ecs

View all ecs actions →