View a markdown version of this page

AWS::EC2::EC2Fleet ReservedCapacityOptionsRequest - AWS CloudFormation

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::EC2::EC2Fleet ReservedCapacityOptionsRequest

Defines EC2 Fleet preferences for utilizing reserved capacity when DefaultTargetCapacityType is set to reserved-capacity. EC2 Fleet can fulfill reserved capacity using On-Demand Capacity Reservations, Capacity Blocks for ML, and interruptible Capacity Reservations.

Note

This configuration can only be used if the EC2 Fleet is of type instant.

When you specify ReservedCapacityOptions, you must also set DefaultTargetCapacityType to reserved-capacity in the TargetCapacitySpecification.

For more information about interruptible Capacity Reservations, see Launch instances into an interruptible Capacity Reservation in the Amazon EC2 User Guide.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

Properties

AllocationStrategy

The strategy that determines the order in which EC2 Fleet launches instances across the reservation types that you specify. The only supported value is prioritized, which launches instances in the priority order that you specify in your launch template overrides. If you don't specify an allocation strategy, instances are launched in a random order.

Required: No

Type: String

Allowed values: prioritized

Update requires: Replacement

CapacityReservationTarget

The Capacity Reservations or Capacity Reservation Resource Groups to use for fulfilling the EC2 Fleet request. You can specify Capacity Reservation IDs or a Capacity Reservation Resource Group ARN, but not both.

Required: No

Type: CapacityReservationTargetRequest

Update requires: Replacement

ReservationTypes

The types of Capacity Reservations to use for fulfilling the EC2 Fleet request. This is an ordered list: EC2 Fleet attempts to launch instances into each Capacity Reservation type in the order that you specify them before moving on to the next type.

Required: No

Type: Array of String

Allowed values: on-demand-capacity-reservation | capacity-block | interruptible-capacity-reservation

Update requires: Replacement

ReservedCapacityFallbackOptions

The fallback behavior for the EC2 Fleet when there is not enough reserved capacity available to meet the target capacity. This member takes a ReservedCapacityFallbackOptionsRequest structure, in which you set MarketTypes to the instance purchasing options to fall back to.

Required: No

Type: ReservedCapacityFallbackOptionsRequest

Update requires: Replacement