Create a Capacity Reservation
You can create a Capacity Reservation at any time to ensure that you have compute capacity available
in a specific Availability Zone. A Capacity Reservation can start immediately, or it can
start at a future date. The capacity becomes available for use only once the Capacity Reservation enters
the active
state.
If you create a Capacity Reservation with open
instance matching criteria, and you
have running instances with matching attributes at the time the Capacity Reservation becomes active,
those instances automatically run in the reserved capacity. To avoid this, use
targeted
instance matching criteria. For more information, see
Instance matching criteria.
Your request to create a Capacity Reservation could fail if one of the following is true:
-
Amazon EC2 does not have sufficient capacity to fulfill the request. Either try
again at a later time, try a different Availability Zone, or try a smaller
request. If your application is flexible across instance types and sizes, try
different instance attributes.
-
The requested quantity exceeds your On-Demand Instance limit for the selected instance
family. Increase your On-Demand Instance limit for the instance family and try again. For
more information, see On-Demand Instance quotas.
You create a Capacity Reservation for immediate use using one of the following methods:
- Console
-
To create a Capacity Reservation using the console
Open the Amazon EC2 console at
https://console.aws.amazon.com/ec2/.
-
Choose Capacity Reservations, and then choose
Create Capacity Reservation.
-
Configure the following settings in the Instance
details section.
-
Instance Type — The
instance type for which to reserve capacity.
-
Platform — The operating
system for your instances. For more information, see
Supported platforms.
-
Availability Zone — The
Availability Zone in which to reserve the
capacity.
-
Tenancy — The type of
tenancy to use for the reserved capacity. Choose Default
to reserve capacity on shared hardware, or Dedicated to
reserve capacity on hardware that is dedicated to your
account.
-
(Optional) Placement
group ARN — The ARN of the cluster
placement group in which to create the Capacity Reservation. For more
information, see Create Capacity Reservations in cluster placement groups.
-
Total instance count — The
number of instances for which to reserve capacity. If
you specify a quantity that exceeds your remaining On-Demand Instance
quota for the selected instance type, the request
fails.
-
Configure the following settings in the Reservation
details section:
-
Capacity Reservation starts — Choose
Immediately.
-
Capacity Reservation ends — Choose one of
the following options:
-
Instance eligibility —
Choose one of the following options:
-
open — (Default)
The Capacity Reservation matches any instance that has matching
attributes (instance type, platform, Availability
Zone, and tenancy). If you launch an instance with
matching attributes, it is placed into the
reserved capacity automatically.
-
targeted — The
Capacity Reservation only accepts instances that have matching
attributes (instance type, platform, Availability
Zone, and tenancy), and that explicitly target the
reservation.
-
Choose Create.
- AWS CLI
-
To create a Capacity Reservation using the AWS CLI
Use the create-capacity-reservation command.
aws ec2 create-capacity-reservation \
--availability-zone az_name
\
--instance-type instance_type
\
--instance-count number_of_instances
\
--instance-platform operating_system
\
--instance-match-criteria open|targeted
Create a future-dated Capacity Reservation
Request a future-dated Capacity Reservation if you need the reserved capacity to become available
at a future date and time. You can request future-dated Capacity Reservations for instance types in
the C, I, M, R, or T instance families only. For more information, see Amazon EC2 instance type naming conventions.
You can request future-dated Capacity Reservations for an instance count with a minimum of 100
vCPUs. For example, if you request a future-dated Capacity Reservation for m5.xlarge
instances, you must request at least 25 instances (25 * m5.xlarge = 100
vCPUs).
You can request a future-dated Capacity Reservation between 5 and 120 days in advance. However, we
recommend that you request it at least 56 days (8 weeks) in advance to improve
supportability.
After you request a future-dated Capacity Reservation, the request undergoes an assessment to
determine whether it can be supported. For more information, see Future-dated Capacity Reservation assessment.
You can request a future-dated Capacity Reservation using one of the following methods:
- Console
-
To create a Capacity Reservation using the console
Open the Amazon EC2 console at
https://console.aws.amazon.com/ec2/.
-
Choose Capacity Reservations, and then choose
Create Capacity Reservation.
-
Configure the following settings in the Instance
details section.
-
Instance Type — The
instance type for which to reserve capacity.
-
Platform — The operating
system for your instances. For more information, see
Supported platforms.
-
Availability Zone — The
Availability Zone in which to reserve the
capacity.
-
Tenancy — The type of
tenancy to use for the reserved capacity. Choose Default
to reserve capacity on shared hardware, or Dedicated to
reserve capacity on hardware that is dedicated to your
account.
-
Total instance count — The
number of instances for which to reserve capacity. If
you specify a quantity that exceeds your remaining On-Demand Instance
quota for the selected instance type, the request
fails.
-
Configure the following settings in the Reservation
details section:
-
Capacity Reservation starts — Choose
At a specific time.
-
Start date — Specify the
date and time at which the Capacity Reservation must become availble for
use. For more information, see Start date and time.
-
Commitment duration —
Specify the minimum duration for which you commit
keeping the Capacity Reservation after it has been delivered. For more
information, see Commitment duration.
-
Capacity Reservation ends — Choose one of
the following options:
-
Choose Create.
- AWS CLI
-
To create a Capacity Reservation using the AWS CLI
Use the create-capacity-reservation command.
aws ec2 create-capacity-reservation \
--availability-zone az_name
\
--instance-type instance_type
\
--instance-count number_of_instances
\
--instance-platform operating_system
\
--instance-match-criteria targeted \
--delivery-preference incremental \
--commitment-duration commitment_in_seconds
\
--start-date YYYY-MMDDThh:mm:ss.sssZ