ssm:UpdateInstanceInformation

Write

ssm:UpdateInstanceInformation is a Write access-level action in the ssm service. Grants permission to SSM Agent to send a heartbeat signal to the Systems Manager service in the cloud

Resource types

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

arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
instance
arn:${Partition}:ssm:${Region}:${Account}:managed-instance/${InstanceId}
managed-instance

Condition keys

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

ec2:SourceInstanceARN ARN

Filters access by the ARN of the instance from which the request originated

ssm:SourceInstanceARN ARN

Filters access by verifying the Amazon Resource Name (ARN) of the AWS Systems Manager's managed instance from which the request is made. This key is not present when the request comes from the managed instance authenticated with an IAM role associated with EC2 instance profile

aws:ResourceTag/${TagKey} String

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

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

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

Related actions in ssm

View all ssm actions →