aws-cdk-lib.aws_ec2.CfnLaunchTemplate.SpotOptionsProperty

SpotOptionsProperty Struct

Specifies options for Spot Instances.

SpotOptions is a property of AWS::EC2::LaunchTemplate InstanceMarketOptions .

Source

Generated code

Type last changed

v2.93.0 · 23 Aug 2023

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 spotOptionsProperty: ec2.CfnLaunchTemplate.SpotOptionsProperty = {
  blockDurationMinutes: 123,
  instanceInterruptionBehavior: 'instanceInterruptionBehavior',
  maxPrice: 'maxPrice',
  spotInstanceType: 'spotInstanceType',
  validUntil: 'validUntil',
};

Properties

blockDurationMinutesnumberblock_duration_minutesint | floatblockDurationMinutesNumberBlockDurationMinutesdoubleBlockDurationMinutes*float64#

Deprecated.

instanceInterruptionBehaviorstringinstance_interruption_behaviorstrinstanceInterruptionBehaviorStringInstanceInterruptionBehaviorstringInstanceInterruptionBehavior*string#

The behavior when a Spot Instance is interrupted.

The default is terminate .

maxPricestringmax_pricestrmaxPriceStringMaxPricestringMaxPrice*string#

The maximum hourly price you're willing to pay for a Spot Instance.

notes

We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price. If you do specify this parameter, it must be more than USD $0.001. Specifying a value below USD $0.001 will result in an InvalidParameterValue error message when the launch template is used to launch an instance.

If you specify a maximum price, your Spot Instances will be interrupted more frequently than if you do not specify this parameter.

spotInstanceTypestringspot_instance_typestrspotInstanceTypeStringSpotInstanceTypestringSpotInstanceType*string#

The Spot Instance request type.

If you are using Spot Instances with an Auto Scaling group, use one-time requests, as the Amazon EC2 Auto Scaling service handles requesting new Spot Instances whenever the group is below its desired capacity.

validUntilstringvalid_untilstrvalidUntilStringValidUntilstringValidUntil*string#

The end date of the request, in UTC format ( *YYYY-MM-DD* T *HH:MM:SS* Z). Supported only for persistent requests.

notes

• For a persistent request, the request remains active until the ValidUntil date and time is reached. Otherwise, the request remains active until you cancel it.
• For a one-time request, ValidUntil is not supported. The request remains active until all instances launch or you cancel the request.

Default: 7 days from the current date