AWSTransformApplicationECSDeploymentPolicy

OperatorService roleActivePermissions reviewedShow on map Compare

Summary

Enables the AWS Transform to deploy applications to Amazon Elastic Container Service (ECS) with Fargate. It grants permissions to provision, configure, and manage the underlying infrastructure required to run applications on ECS.

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

Identity

ARN: arn:aws:iam::aws:policy/service-role/AWSTransformApplicationECSDeploymentPolicy
Default version: v7
Created: 2025-09-29
Last edited: 2026-09-11
Services: cloudformation, ec2, ecr, ecs, iam, kms, logs

Control-plane actions (41)

By access level: 9 List, 1 Permissions management, 7 Read, 7 Tagging, 17 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
CloudFormation	7 of 104	1 List, 1 Read, 2 Tagging, 3 Write; 7 restricted, 7 conditional	cloudformation:CreateStack, cloudformation:DeleteStack, cloudformation:DescribeStackEvents, cloudformation:DescribeStacks, cloudformation:TagResource, cloudformation:UntagResource, cloudformation:UpdateStack
EC2	2 of 834	2 List; 0 restricted, 0 conditional	ec2:DescribeNetworkInterfaces, ec2:DescribeSecurityGroups
Elastic Container Registry	2 of 65	1 Tagging, 1 Write; 2 restricted, 2 conditional	ecr:CreateRepository, ecr:TagResource
Elastic Container Service	14 of 92	1 List, 3 Read, 2 Tagging, 8 Write; 12 restricted, 12 conditional	ecs:CreateCluster, ecs:CreateService, ecs:DeleteCluster, ecs:DeleteService, ecs:DescribeClusters, ecs:DescribeServices, ecs:DescribeTasks, ecs:ListTasks, ecs:RegisterTaskDefinition, ecs:RunTask, ecs:TagResource, ecs:UntagResource and 2 more
IAM	6 of 190	2 List, 2 Read, 2 Write; 6 restricted, 6 conditional	iam:CreateServiceLinkedRole, iam:GetRole, iam:GetRolePolicy, iam:ListAttachedRolePolicies, iam:ListRolePolicies, iam:PassRole
KMS	1 of 58	1 Permissions management; 1 restricted, 1 conditional	kms:CreateGrant
CloudWatch Logs	9 of 133	3 List, 1 Read, 2 Tagging, 3 Write; 6 restricted, 6 conditional	logs:CreateLogGroup, logs:DeleteLogGroup, logs:DescribeLogGroups, logs:DescribeLogStreams, logs:GetLogEvents, logs:ListTagsForResource, logs:PutRetentionPolicy, logs:TagResource, logs:UntagResource

CloudFormation: 7 actions

cloudformation:CreateStack (Write)
cloudformation:DeleteStack (Write)
cloudformation:DescribeStackEvents (Read)
cloudformation:DescribeStacks (List)
cloudformation:TagResource (Tagging)
cloudformation:UntagResource (Tagging)
cloudformation:UpdateStack (Write)

EC2: 2 actions

ec2:DescribeNetworkInterfaces (List)
ec2:DescribeSecurityGroups (List)

Elastic Container Registry: 2 actions

ecr:CreateRepository (Write)
ecr:TagResource (Tagging)

Elastic Container Service: 14 actions

ecs:CreateCluster (Write)
ecs:CreateService (Write)
ecs:DeleteCluster (Write)
ecs:DeleteService (Write)
ecs:DescribeClusters (Read)
ecs:DescribeServices (Read)
ecs:DescribeTasks (Read)
ecs:ListTasks (List)
ecs:RegisterTaskDefinition (Write)
ecs:RunTask (Write)
ecs:TagResource (Tagging)
ecs:UntagResource (Tagging)
ecs:UpdateCluster (Write)
ecs:UpdateService (Write)

IAM: 6 actions

iam:CreateServiceLinkedRole (Write)
iam:GetRole (Read)
iam:GetRolePolicy (Read)
iam:ListAttachedRolePolicies (List)
iam:ListRolePolicies (List)
iam:PassRole (Write)

KMS: 1 actions

kms:CreateGrant (Permissions management)

CloudWatch Logs: 9 actions

logs:CreateLogGroup (Write)
logs:DeleteLogGroup (Write)
logs:DescribeLogGroups (List)
logs:DescribeLogStreams (List)
logs:GetLogEvents (Read)
logs:ListTagsForResource (List)
logs:PutRetentionPolicy (Write)
logs:TagResource (Tagging)
logs:UntagResource (Tagging)

Data-plane actions (0)

By access level: none.

This policy grants no actions in this plane.

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 25 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": [
    {
      "Effect": "Allow",
      "Action": "cloudformation:CreateStack",
      "Resource": "arn:aws:cloudformation:*:*:stack/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:UpdateStack",
        "cloudformation:DeleteStack"
      ],
      "Resource": "arn:aws:cloudformation:*:*:stack/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:ResourceTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Sid": "CloudFormationTagOnCreate",
      "Effect": "Allow",
      "Action": [
        "cloudformation:TagResource",
        "cloudformation:UntagResource"
      ],
      "Resource": "arn:aws:cloudformation:*:*:stack/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "cloudformation:CreateAction": [
            "CreateStack",
            "UpdateStack"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:DescribeStacks",
        "cloudformation:DescribeStackEvents"
      ],
      "Resource": "arn:aws:cloudformation:*:*:stack/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:CreateCluster",
      "Resource": "arn:aws:ecs:*:*:cluster/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:UpdateCluster",
        "ecs:DeleteCluster"
      ],
      "Resource": "arn:aws:ecs:*:*:cluster/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "ecs:ResourceTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:RegisterTaskDefinition",
      "Resource": "arn:aws:ecs:*:*:task-definition/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:RunTask",
      "Resource": "arn:aws:ecs:*:*:task-definition/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:ResourceTag/CreatedBy": "AWSTransform"
        },
        "ArnLike": {
          "ecs:cluster": "arn:aws:ecs:*:*:cluster/AWSTransform*"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:ListTasks",
      "Resource": "arn:aws:ecs:*:*:container-instance/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        },
        "ArnLike": {
          "ecs:cluster": "arn:aws:ecs:*:*:cluster/AWSTransform*"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:DescribeTasks",
      "Resource": "arn:aws:ecs:*:*:task/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        },
        "ArnLike": {
          "ecs:cluster": "arn:aws:ecs:*:*:cluster/AWSTransform*"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": [
        "arn:aws:iam::*:role/AWSTransform-Deploy-ECS-Task-Role",
        "arn:aws:iam::*:role/AWSTransform-Deploy-ECS-Execution-Role"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "iam:PassedToService": [
            "ecs-tasks.amazonaws.com",
            "ecs.amazonaws.com"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:GetRole",
        "iam:GetRolePolicy",
        "iam:ListRolePolicies",
        "iam:ListAttachedRolePolicies"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AWSTransform-Deploy-ECS-Task-Role",
        "arn:aws:iam::*:role/AWSTransform-Deploy-ECS-Execution-Role"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "ecs:CreateService",
      "Resource": "arn:aws:ecs:*:*:service/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:UpdateService",
        "ecs:DeleteService"
      ],
      "Resource": "arn:aws:ecs:*:*:service/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "ecs:ResourceTag/CreatedBy": "AWSTransform"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:TagResource",
        "ecs:UntagResource"
      ],
      "Resource": [
        "arn:aws:ecs:*:*:cluster/AWSTransform*",
        "arn:aws:ecs:*:*:task-definition/AWSTransform*",
        "arn:aws:ecs:*:*:service/AWSTransform*",
        "arn:aws:ecs:*:*:task/AWSTransform*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "ResourceName",
            "CreatedBy",
            "TransformationType"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:TagResource"
      ],
      "Resource": "arn:aws:logs:*:*:log-group:/aws/ecs/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "ResourceName",
            "CreatedBy",
            "TransformationType"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "logs:DeleteLogGroup",
        "logs:PutRetentionPolicy"
      ],
      "Resource": "arn:aws:logs:*:*:log-group:/aws/ecs/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "logs:UntagResource",
      "Resource": "arn:aws:logs:*:*:log-group:/aws/ecs/AWSTransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "ResourceName",
            "CreatedBy",
            "TransformationType"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "logs:GetLogEvents",
      "Resource": "arn:aws:logs:*:*:log-group:/aws/ecs/AWSTransform*:log-stream:*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecr:CreateRepository",
        "ecr:TagResource"
      ],
      "Resource": "arn:aws:ecr:*:*:repository/awstransform*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "aws:RequestTag/CreatedBy": "AWSTransform"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "ResourceName",
            "CreatedBy",
            "TransformationType"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeClusters",
        "ecs:DescribeServices",
        "ec2:DescribeSecurityGroups",
        "ec2:DescribeNetworkInterfaces",
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams",
        "logs:ListTagsForResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:CreateServiceLinkedRole"
      ],
      "Resource": "arn:aws:iam::*:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
      "Condition": {
        "StringEquals": {
          "iam:AWSServiceName": "ecs.amazonaws.com"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "kms:CreateGrant"
      ],
      "Resource": "arn:aws:kms:*:*:key/*",
      "Condition": {
        "Bool": {
          "kms:GrantIsForAWSResource": "true"
        },
        "StringLike": {
          "kms:ViaService": [
            "ecr.*.amazonaws.com"
          ],
          "kms:EncryptionContext:aws:ecr:arn": "*"
        },
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}",
          "kms:GrantConstraintType": "EncryptionContextSubset"
        },
        "ForAllValues:StringEquals": {
          "kms:GrantOperations": [
            "Decrypt",
            "GenerateDataKey"
          ]
        }
      }
    }
  ]
}

Version history

Current version v7, edited by AWS on 2026-09-11. 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/service-role/AWSTransformApplicationECSDeploymentPolicy
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/service-role/AWSTransformApplicationECSDeploymentPolicy
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/service-role/AWSTransformApplicationECSDeploymentPolicy

CloudFormation

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

Terraform

resource "aws_iam_role_policy_attachment" "service_role_awstransformapplicationecsdeploymentpolicy" {
  role       = aws_iam_role.example.name
  policy_arn = "arn:aws:iam::aws:policy/service-role/AWSTransformApplicationECSDeploymentPolicy"
}

CDK (TypeScript)

role.addManagedPolicy(
  iam.ManagedPolicy.fromAwsManagedPolicyName("service-role/AWSTransformApplicationECSDeploymentPolicy"),
);

Sources

Pending editorial review. No editorial sources are listed yet.