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. The MaxTotalPrice does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for MaxTotalPrice. 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 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