ssm:StartChangeRequestExecution

Write

ssm:StartChangeRequestExecution is a Write access-level action in the ssm service. Grants permission to initiate the execution of an Automation Change Template document

Resource types

ARNs that ssm:StartChangeRequestExecution can be scoped to in an IAM policy.

arn:${Partition}:ssm:${Region}:${Account}:automation-execution/${AutomationExecutionId}
automation-execution
arn:${Partition}:ssm:${Region}:${Account}:document/${DocumentName}
document
arn:${Partition}:ssm:${Region}:${Account}:automation-definition/${AutomationDefinitionName}:${VersionId}
automation-definition

Condition keys

Keys you can use in the Condition block of a policy that grants ssm:StartChangeRequestExecution.

aws:ResourceTag/${TagKey} String

Filters access by based on a tag key-value pair assigned to the AWS resource

ssm:DocumentCategories ArrayOfString

Filters access by verifying that a user has permission to access a document belonging to a specific category enum

ssm:DocumentType String

Filters access by verifying that a user has permission to access a document belonging to a specific document type. Only available in "aws", "aws-cn", and "aws-us-gov" partitions

ssm:resourceTag/${TagKey} String

Filters access by a tag key-value pair assigned to the Systems Manager resource

ssm:resourceTag/tag-key String

Filters access by based on a tag key-value pair assigned to the Systems Manager resource

Example IAM policy

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowSsmStartChangeRequestExecution",
      "Effect": "Allow",
      "Action": "ssm:StartChangeRequestExecution",
      "Resource": "*"
    }
  ]
}

Related actions in ssm

View all ssm actions →