AmazonECSInstanceRolePolicyForManagedInstances

OperatorAWS managedActivePermissions reviewedShow on map Compare

Summary

Default policy for the Amazon ECS Instance Role for Amazon ECS Managed Instances.

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

Identity

ARN: arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances
Default version: v4
Created: 2025-09-26
Last edited: 2026-07-02
Services: ecs

Control-plane actions (7)

By access level: 7 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
Elastic Container Service	7 of 92	7 Write; 6 restricted, 0 conditional	ecs:DiscoverPollEndpoint, ecs:Poll, ecs:PutSystemLogEvents, ecs:RegisterContainerInstance, ecs:StartTelemetrySession, ecs:SubmitAttachmentStateChanges, ecs:SubmitTaskStateChange

Elastic Container Service: 7 actions

ecs:DiscoverPollEndpoint (Write)
ecs:Poll (Write)
ecs:PutSystemLogEvents (Write)
ecs:RegisterContainerInstance (Write)
ecs:StartTelemetrySession (Write)
ecs:SubmitAttachmentStateChanges (Write)
ecs:SubmitTaskStateChange (Write)

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 7 write, tagging or permissions-management actions, short of full control of any service.

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": [
    {
      "Sid": "ECSAgentDiscoverPollEndpointPermissions",
      "Effect": "Allow",
      "Action": [
        "ecs:DiscoverPollEndpoint"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ECSAgentRegisterPermissions",
      "Effect": "Allow",
      "Action": [
        "ecs:RegisterContainerInstance"
      ],
      "Resource": "arn:aws:ecs:*:*:cluster/*"
    },
    {
      "Sid": "ECSAgentPollPermissions",
      "Effect": "Allow",
      "Action": [
        "ecs:Poll"
      ],
      "Resource": [
        "arn:aws:ecs:*:*:container-instance/*",
        "arn:aws:ecs:*:*:task-set/*"
      ]
    },
    {
      "Sid": "ECSAgentTelemetryPermissions",
      "Effect": "Allow",
      "Action": [
        "ecs:StartTelemetrySession",
        "ecs:PutSystemLogEvents"
      ],
      "Resource": "arn:aws:ecs:*:*:container-instance/*"
    },
    {
      "Sid": "ECSAgentStateChangePermissions",
      "Effect": "Allow",
      "Action": [
        "ecs:SubmitAttachmentStateChanges",
        "ecs:SubmitTaskStateChange"
      ],
      "Resource": "arn:aws:ecs:*:*:cluster/*"
    }
  ]
}

Version history

Current version v4, edited by AWS on 2026-07-02. 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/AmazonECSInstanceRolePolicyForManagedInstances
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances

CloudFormation

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

Terraform

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

CDK (TypeScript)

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

Sources

Pending editorial review. No editorial sources are listed yet.