AWS Fundamentals Logo
AWS Fundamentals
AWS::EC2::CapacityReservation

EC2 CapacityReservation

Resource Type definition for AWS::EC2::CapacityReservation

Properties

15 configurable properties. 3 required. Click a row to see details.

Filter:
PropertyTypeFlags
InstanceCount
integer
Required
InstancePlatform
string
RequiredCreate-only
InstanceType
string
RequiredCreate-only
AvailabilityZone
string
Create-only
AvailabilityZoneId
string
Create-only
EbsOptimized
boolean
Create-only
EndDate
string
EndDateType
string
EphemeralStorage
boolean
Create-only
InstanceMatchCriteria
string
OutPostArn
string
Create-only
PlacementGroupArn
string
Create-only
TagSpecifications
Array<TagSpecification>
Create-only
Tenancy
string
Create-only
UnusedReservationBillingOwnerId
string
Write-only

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

AttributeTypeDescription
AvailableInstanceCountinteger-
CapacityAllocationSetArray<CapacityAllocation>-
CapacityReservationArnstring-
CapacityReservationFleetIdstring-
CommitmentInfoobject-
CreateDatestring-
DeliveryPreferencestring-
Idstring-
OwnerIdstring-
ReservationTypestring-
StartDatestring-
Statestring-
TotalInstanceCountinteger-

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::EC2::CapacityReservation

Resources:
  MyResource:
    Type: AWS::EC2::CapacityReservation
    Properties:
      InstanceCount: 1
      InstancePlatform: "value"
      InstanceType: "value"

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

read

ec2:DescribeCapacityReservations

create

ec2:CreateCapacityReservationec2:DescribeCapacityReservationsec2:CancelCapacityReservationec2:CreateTags

update

ec2:ModifyCapacityReservationec2:CreateCapacityReservationec2:DescribeCapacityReservationsec2:CancelCapacityReservationec2:AssociateCapacityReservationBillingOwnerec2:CreateTagsec2:DeleteTags

list

ec2:DescribeCapacityReservations

delete

ec2:CreateCapacityReservationec2:DescribeCapacityReservationsec2:CancelCapacityReservationec2:DeleteTags

Get the EC2 Cheat Sheet

Everything you need to know about EC2 on one page. HD quality, print-friendly.

Download Free Infographic

Quick Facts

ServiceEC2
Properties28
Required3
TaggingSupported
Primary IDId

Supported Operations

ReadCreateUpdateListDelete

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

TenancyInstancePlatformInstanceTypeAvailabilityZoneTagSpecificationsOutPostArnEphemeralStorageEbsOptimizedPlacementGroupArnAvailabilityZoneId

Related Resources

External Links