AWS::EC2::EC2Fleet OnDemandOptionsRequest
Specifies the allocation strategy of On-Demand Instances in an EC2 Fleet.
OnDemandOptionsRequest
is a property of the AWS::EC2::EC2Fleet resource.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "AllocationStrategy" :
String
, "CapacityReservationOptions" :CapacityReservationOptionsRequest
, "MaxTotalPrice" :String
, "MinTargetCapacity" :Integer
, "SingleAvailabilityZone" :Boolean
, "SingleInstanceType" :Boolean
}
YAML
AllocationStrategy:
String
CapacityReservationOptions:CapacityReservationOptionsRequest
MaxTotalPrice:String
MinTargetCapacity:Integer
SingleAvailabilityZone:Boolean
SingleInstanceType:Boolean
Properties
AllocationStrategy
-
The strategy that determines the order of the launch template overrides to use in fulfilling On-Demand capacity.
lowest-price
- EC2 Fleet uses price to determine the order, launching the lowest price first.prioritized
- EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first.Default:
lowest-price
Required: No
Type: String
Allowed values:
lowest-price | prioritized
Update requires: Replacement
CapacityReservationOptions
-
The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.
Supported only for fleets of type
instant
.Required: No
Type: CapacityReservationOptionsRequest
Update requires: Replacement
MaxTotalPrice
-
The maximum amount per hour for On-Demand Instances that you're willing to pay.
Note
If your fleet includes T instances that are configured as
unlimited
, and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. TheMaxTotalPrice
does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified forMaxTotalPrice
. For more information, see Surplus credits can incur charges in the Amazon EC2 User Guide.Required: No
Type: String
Update requires: Replacement
MinTargetCapacity
-
The minimum target capacity for On-Demand Instances in the fleet. If this minimum capacity isn't reached, no instances are launched.
Constraints: Maximum value of
1000
. Supported only for fleets of typeinstant
.At least one of the following must be specified:
SingleAvailabilityZone
|SingleInstanceType
Required: No
Type: Integer
Update requires: Replacement
SingleAvailabilityZone
-
Indicates that the fleet launches all On-Demand Instances into a single Availability Zone.
Supported only for fleets of type
instant
.Required: No
Type: Boolean
Update requires: Replacement
SingleInstanceType
-
Indicates that the fleet uses a single instance type to launch all On-Demand Instances in the fleet.
Supported only for fleets of type
instant
.Required: No
Type: Boolean
Update requires: Replacement
See also
-
OnDemandOptionsRequest in the Amazon EC2 API Reference