AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy

OperatorAWS managedActivePermissions reviewedShow on map Compare

Summary

Provide permission for Diagnosing issues with SSM services by executing activities defined within Automation Documents, primarily used for running the Automation documents in a cross-account cross-region setup by triggering child automations within member accounts.

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

Identity

ARN: arn:aws:iam::aws:policy/AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy
Default version: v5
Created: 2024-11-16
Last edited: 2026-08-29
Services: iam, kms, s3, ssm, sts

Control-plane actions (8)

By access level: 3 Read, 5 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
IAM	1 of 190	1 Write; 1 restricted, 1 conditional	iam:PassRole
KMS	2 of 58	2 Write; 2 restricted, 2 conditional	kms:Decrypt, kms:GenerateDataKey
Systems Manager	4 of 164	3 Read, 1 Write; 1 restricted, 0 conditional	ssm:DescribeAutomationExecutions, ssm:DescribeAutomationStepExecutions, ssm:GetAutomationExecution, ssm:StartAutomationExecution
STS	1 of 16	1 Write; 1 restricted, 1 conditional	sts:AssumeRole

IAM: 1 actions

iam:PassRole (Write)

KMS: 2 actions

kms:Decrypt (Write)
kms:GenerateDataKey (Write)

Systems Manager: 4 actions

ssm:DescribeAutomationExecutions (Read)
ssm:DescribeAutomationStepExecutions (Read)
ssm:GetAutomationExecution (Read)
ssm:StartAutomationExecution (Write)

STS: 1 actions

sts:AssumeRole (Write)

Data-plane actions (4)

By access level: 1 List, 1 Read, 2 Write.

Data-plane actions by service
Service	Granted	Access levels and limits	Granted by
S3	4 of 25	1 List, 1 Read, 2 Write; 4 restricted, 4 conditional	s3:DeleteObject, s3:GetObject, s3:ListBucket, s3:PutObject

S3: 4 actions

s3:DeleteObject (Write)
s3:GetObject (Read)
s3:ListBucket (List)
s3:PutObject (Write)

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.
Grants data-plane write actions on a data store, but only for scoped resources or under conditions.
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": [
    {
      "Sid": "AllowReadOnlyAccessSSMResource",
      "Effect": "Allow",
      "Action": [
        "ssm:DescribeAutomationExecutions",
        "ssm:DescribeAutomationStepExecutions",
        "ssm:GetAutomationExecution"
      ],
      "Resource": "*"
    },
    {
      "Sid": "AllowExecuteSSMAutomation",
      "Effect": "Allow",
      "Action": [
        "ssm:StartAutomationExecution"
      ],
      "Resource": [
        "arn:aws:ssm:*:*:document/AWS-*UnmanagedEC2*",
        "arn:aws:ssm:*:*:document/AWS-DiagnoseHybridActivationIssues",
        "arn:aws:ssm:*:*:automation-execution/*",
        "arn:aws:ssm:*:*:automation-definition/AWS-*UnmanagedEC2*:*",
        "arn:aws:ssm:*:*:automation-definition/AWS-DiagnoseHybridActivationIssues:*"
      ]
    },
    {
      "Sid": "AllowKMSOperations",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "arn:aws:kms:*:*:key/*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/SystemsManagerManaged": "true"
        },
        "ArnLike": {
          "kms:EncryptionContext:aws:s3:arn": "arn:aws:s3:::do-not-delete-ssm-diagnosis-*"
        },
        "StringLike": {
          "kms:ViaService": "s3.*.amazonaws.com"
        },
        "Bool": {
          "aws:ViaAWSService": "true"
        }
      }
    },
    {
      "Sid": "AllowAssumeDiagnosisExecutionRoleWithinAccount",
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::*:role/AWS-SSM-DiagnosisExecutionRole*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Sid": "AllowPassRoleOnSelfToSsm",
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "arn:aws:iam::*:role/AWS-SSM-DiagnosisAdminRole*",
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": "ssm.amazonaws.com"
        }
      }
    },
    {
      "Sid": "AllowReadWriteToSsmDiagnosisBucketInSameAccount",
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject"
      ],
      "Resource": "arn:aws:s3:::do-not-delete-ssm-diagnosis-*/actions/*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    },
    {
      "Sid": "AllowListBucketOnSsmDiagnosisBucketInSameAccount",
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket"
      ],
      "Resource": "arn:aws:s3:::do-not-delete-ssm-diagnosis-*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "${aws:PrincipalAccount}"
        }
      }
    }
  ]
}

Version history

Current version v5, edited by AWS on 2026-08-29. 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/AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy

CloudFormation

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

Terraform

resource "aws_iam_role_policy_attachment" "aws_ssm_diagnosisautomation_administrationrolepolicy" {
  role       = aws_iam_role.example.name
  policy_arn = "arn:aws:iam::aws:policy/AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy"
}

CDK (TypeScript)

role.addManagedPolicy(
  iam.ManagedPolicy.fromAwsManagedPolicyName("AWS-SSM-DiagnosisAutomation-AdministrationRolePolicy"),
);

Sources

Pending editorial review. No editorial sources are listed yet.