ec2:GetCapacityReservationUsage

Read

ec2:GetCapacityReservationUsage is a Read access-level action in the ec2 service. Grants permission to get usage information about a Capacity Reservation

Resource types

ARNs that ec2:GetCapacityReservationUsage can be scoped to in an IAM policy.

arn:${Partition}:ec2:${Region}:${Account}:capacity-reservation/${CapacityReservationId}
capacity-reservation

Condition keys

Keys you can use in the Condition block of a policy that grants ec2:GetCapacityReservationUsage.

aws:RequestTag/${TagKey} String

Filters access by a tag key and value pair that is allowed in the request

aws:ResourceTag/${TagKey} String

Filters access by a tag key and value pair of a resource

aws:TagKeys ArrayOfString

Filters access by a list of tag keys that are allowed in the request

ec2:Attribute String

Filters access by an attribute of a resource

ec2:Attribute/${AttributeName} String

Filters access by an attribute being set on a resource

ec2:AvailabilityZone String

Filters access by the name of an Availability Zone in an AWS Region

ec2:AvailabilityZoneId String

Filters access by the ID of an Availability Zone in an AWS Region

ec2:CapacityReservationFleet ARN

Filters access by the ARN of the Capacity Reservation Fleet

ec2:CommitmentDuration Numeric

Filters access by commitment duration of the Capacity Reservation

ec2:CreateDate Date

Filters access by the date and time at which the Capacity Reservation was created

ec2:DestinationCapacityReservationId ARN

Filters access by the ID of the Capacity Reservation that you want to move capacity into

ec2:EbsOptimized Bool

Filters access by whether the instance is enabled for EBS optimization

ec2:PlacementGroup ARN

Filters access by the ARN of the placement group

ec2:EndDate Date

Filters access by the date and time at which the Capacity Reservation ends

ec2:EndDateType String

Filters access by the way in which the Capacity Reservation ends

ec2:EphemeralStorage Bool

Filters access by whether the instance is enabled for ephemeral storage

ec2:Region String

Filters access by the name of the AWS Region

ec2:InstanceCount Numeric

Filters access by the number of instances

ec2:ResourceTag/${TagKey} String

Filters access by a tag key and value pair of a resource

ec2:InstanceMatchCriteria String

Filters access by the type of instance launches that the Capacity Reservation accepts

ec2:InstancePlatform ARN

Filters access by the type of operating system for which the Capacity Reservation reserves capacity

ec2:InstanceType String

Filters access by the type of instance

ec2:InterruptibleCapacityReservationId String

Filters access by the ID of an interruptible Capacity Reservation

ec2:InterruptionType String

Filters access by the type of interruption

ec2:SourceCapacityReservationId ARN

Filters access by the ID of the Capacity Reservation from which you want to move capacity

ec2:IsInterruptible Bool

Filters access by whether Capacity Reservations are interruptible

ec2:IsLaunchTemplateResource Bool

Filters access by whether users are able to override resources that are specified in the launch template

ec2:TargetInstanceCount Numeric

Filters access by the number of instances the interruptible Capacity Reservation is assigned

ec2:LaunchTemplate ARN

Filters access by the ARN of a launch template

ec2:Tenancy String

Filters access by the tenancy of the VPC or instance (default, dedicated, or host)

ec2:OutpostArn ARN

Filters access by the ARN of the Outpost

Example IAM policy

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEc2GetCapacityReservationUsage",
      "Effect": "Allow",
      "Action": "ec2:GetCapacityReservationUsage",
      "Resource": "*"
    }
  ]
}

Related actions in ec2

View all ec2 actions →