AWSCodeDeployRoleForECSLimited

OperatorAWS managedActivePermissions reviewedShow on map Compare

Summary

Provides CodeDeploy service limited access to perform an ECS blue/green deployment on your behalf.

Permissions imported from the AWS Managed Policy Reference Guide; other sections pending editorial review.

Identity

ARN: arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited
Default version: v3
Created: 2018-11-27
Last edited: 2019-09-23
Services: cloudwatch, ecs, elasticloadbalancing, iam, lambda, s3, sns

Control-plane actions (11)

By access level: 5 Read, 6 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
CloudWatch	1 of 160	1 Read; 0 restricted, 0 conditional	cloudwatch:DescribeAlarms
Elastic Container Service	4 of 92	1 Read, 3 Write; 0 restricted, 0 conditional	ecs:CreateTaskSet, ecs:DeleteTaskSet, ecs:DescribeServices, ecs:UpdateServicePrimaryTaskSet
ELB	5 of 77	3 Read, 2 Write; 0 restricted, 0 conditional	elasticloadbalancing:DescribeListeners, elasticloadbalancing:DescribeRules, elasticloadbalancing:DescribeTargetGroups, elasticloadbalancing:ModifyListener, elasticloadbalancing:ModifyRule
IAM	1 of 190	1 Write; 1 restricted, 1 conditional	iam:PassRole

CloudWatch: 1 actions

cloudwatch:DescribeAlarms (Read)

Elastic Container Service: 4 actions

ecs:CreateTaskSet (Write)
ecs:DeleteTaskSet (Write)
ecs:DescribeServices (Read)
ecs:UpdateServicePrimaryTaskSet (Write)

ELB: 5 actions

elasticloadbalancing:DescribeListeners (Read)
elasticloadbalancing:DescribeRules (Read)
elasticloadbalancing:DescribeTargetGroups (Read)
elasticloadbalancing:ModifyListener (Write)
elasticloadbalancing:ModifyRule (Write)

IAM: 1 actions

iam:PassRole (Write)

Data-plane actions (4)

By access level: 2 Read, 2 Write.

Data-plane actions by service
Service	Granted	Access levels and limits	Granted by
Lambda	1 of 14	1 Write; 1 restricted, 0 conditional	lambda:InvokeFunction
S3	2 of 25	2 Read; 2 restricted, 2 conditional	s3:GetObject, s3:GetObjectVersion
SNS	All 1 actions (see the SNS page)	1 Write; 1 restricted, 0 conditional	sns:Publish

Lambda: 1 actions

lambda:InvokeFunction (Write)

S3: 2 actions

s3:GetObject (Read)
s3:GetObjectVersion (Read)

Excluded and conditional actions

No patterns are excluded by NotAction or Deny statements.

Resource scope and attachment

Resource scope across granted actions: mixed.

Can be attached: Yes, to users, groups and roles.

Why this tier

Grants 8 write, tagging or permissions-management actions, short of full control of any service.
Grants iam:PassRole, but only for scoped roles or under conditions (for example iam:PassedToService).

Guidance

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Same service

Same domain

Frequently asked questions

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Policy JSON

Download policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "ecs:DescribeServices",
        "ecs:CreateTaskSet",
        "ecs:UpdateServicePrimaryTaskSet",
        "ecs:DeleteTaskSet",
        "cloudwatch:DescribeAlarms"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "sns:Publish"
      ],
      "Resource": "arn:aws:sns:*:*:CodeDeployTopic_*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "elasticloadbalancing:DescribeTargetGroups",
        "elasticloadbalancing:DescribeListeners",
        "elasticloadbalancing:ModifyListener",
        "elasticloadbalancing:DescribeRules",
        "elasticloadbalancing:ModifyRule"
      ],
      "Resource": "*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "lambda:InvokeFunction"
      ],
      "Resource": "arn:aws:lambda:*:*:function:CodeDeployHook_*",
      "Effect": "Allow"
    },
    {
      "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "s3:ExistingObjectTag/UseWithCodeDeploy": "true"
        }
      },
      "Effect": "Allow"
    },
    {
      "Action": [
        "iam:PassRole"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:iam::*:role/ecsTaskExecutionRole",
        "arn:aws:iam::*:role/ECSTaskExecution*"
      ],
      "Condition": {
        "StringLike": {
          "iam:PassedToService": [
            "ecs-tasks.amazonaws.com"
          ]
        }
      }
    }
  ]
}

Version history

Current version v3, edited by AWS on 2019-09-23. Version history is recorded from 2026-11-11. Earlier versions are in the IAM console under Policy versions.

Attach snippets

AWS CLI

aws iam attach-role-policy --role-name ROLE_NAME --policy-arn arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited

CloudFormation

Resources:
  ExampleRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument: {}  # replace with your trust policy
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited

Terraform

resource "aws_iam_role_policy_attachment" "awscodedeployroleforecslimited" {
  role       = aws_iam_role.example.name
  policy_arn = "arn:aws:iam::aws:policy/AWSCodeDeployRoleForECSLimited"
}

CDK (TypeScript)

role.addManagedPolicy(
  iam.ManagedPolicy.fromAwsManagedPolicyName("AWSCodeDeployRoleForECSLimited"),
);

Sources

Pending editorial review. No editorial sources are listed yet.