ssm:StartSession

Write

ssm:StartSession is a Write access-level action in the ssm service. Grants permission to initiate a connection to a specified target for a Session Manager session

Resource types

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

arn:${Partition}:ssm:${Region}:${Account}:document/${DocumentName}
document
arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
instance
arn:${Partition}:ssm:${Region}:${Account}:managed-instance/${InstanceId}
managed-instance
arn:${Partition}:ecs:${Region}:${Account}:task/${TaskId}
task

Condition keys

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

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:StartSession. Replace "Resource": "*" with a specific ARN to follow least privilege.

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

Related actions in ssm

View all ssm actions →