interface OnDemandOptionsRequestProperty

Language	Type name
.NET	`Amazon.CDK.AWS.EC2.CfnEC2Fleet.OnDemandOptionsRequestProperty`
Go	`github.com/aws/aws-cdk-go/awscdk/v2/awsec2#CfnEC2Fleet_OnDemandOptionsRequestProperty`
Java	`software.amazon.awscdk.services.ec2.CfnEC2Fleet.OnDemandOptionsRequestProperty`
Python	`aws_cdk.aws_ec2.CfnEC2Fleet.OnDemandOptionsRequestProperty`
TypeScript	`aws-cdk-lib` » `aws_ec2` » `CfnEC2Fleet` » `OnDemandOptionsRequestProperty`

Specifies the allocation strategy of On-Demand Instances in an EC2 Fleet.

OnDemandOptionsRequest is a property of the AWS::EC2::EC2Fleet resource.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_ec2 as ec2 } from 'aws-cdk-lib';
const onDemandOptionsRequestProperty: ec2.CfnEC2Fleet.OnDemandOptionsRequestProperty = {
  allocationStrategy: 'allocationStrategy',
  capacityReservationOptions: {
    usageStrategy: 'usageStrategy',
  },
  maxTotalPrice: 'maxTotalPrice',
  minTargetCapacity: 123,
  singleAvailabilityZone: false,
  singleInstanceType: false,
};

Properties

Name	Type	Description
allocationStrategy?	`string`	The strategy that determines the order of the launch template overrides to use in fulfilling On-Demand capacity.
capacityReservationOptions?	`IResolvable` `\|` `CapacityReservationOptionsRequestProperty`	The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.
maxTotalPrice?	`string`	The maximum amount per hour for On-Demand Instances that you're willing to pay.
minTargetCapacity?	`number`	The minimum target capacity for On-Demand Instances in the fleet.
singleAvailabilityZone?	`boolean \|` `IResolvable`	Indicates that the fleet launches all On-Demand Instances into a single Availability Zone.
singleInstanceType?	`boolean \|` `IResolvable`	Indicates that the fleet uses a single instance type to launch all On-Demand Instances in the fleet.

allocationStrategy?

Type: string (optional)

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

capacityReservationOptions?

Type: IResolvable | CapacityReservationOptionsRequestProperty (optional)

The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.

Supported only for fleets of type instant .

maxTotalPrice?

Type: string (optional)

The maximum amount per hour for On-Demand Instances that you're willing to pay.

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 .

minTargetCapacity?

Type: number (optional)

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

singleAvailabilityZone?

Type: boolean | IResolvable (optional)

Indicates that the fleet launches all On-Demand Instances into a single Availability Zone.

Supported only for fleets of type instant .

singleInstanceType?

Type: boolean | IResolvable (optional)

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 .