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 Amazon 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 EC2 User Guide.Required: No
Type: String
Update requires: Replacement
MinTargetCapacity
-
The minimum target capacity for On-Demand Instances in the fleet. If the minimum target capacity is not reached, the fleet launches no instances.
Supported only for fleets of type
instant
.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