AWS::EMR::InstanceFleetConfig SpotProvisioningSpecification - AWS CloudFormation

AWS::EMR::InstanceFleetConfig SpotProvisioningSpecification

SpotProvisioningSpecification is a subproperty of the InstanceFleetProvisioningSpecifications property type. SpotProvisioningSpecification determines the launch specification for Spot instances in the instance fleet, which includes the defined duration and provisioning timeout behavior.

Note

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "AllocationStrategy" : String, "BlockDurationMinutes" : Integer, "TimeoutAction" : String, "TimeoutDurationMinutes" : Integer }

Properties

AllocationStrategy

Specifies the strategy to use in launching Spot Instance fleets. Currently, the only option is capacity-optimized (the default), which launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.

Required: No

Type: String

Allowed values: capacity-optimized

Update requires: No interruption

BlockDurationMinutes

The defined duration for Spot Instances (also known as Spot blocks) in minutes. When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates.

Note

Spot Instances with a defined duration (also known as Spot blocks) are no longer available to new customers from July 1, 2021. For customers who have previously used the feature, we will continue to support Spot Instances with a defined duration until December 31, 2022.

Required: No

Type: Integer

Minimum: 0

Update requires: No interruption

TimeoutAction

The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired; that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND. SWITCH_TO_ON_DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.

Required: Yes

Type: String

Allowed values: SWITCH_TO_ON_DEMAND | TERMINATE_CLUSTER

Update requires: No interruption

TimeoutDurationMinutes

The spot provisioning timeout period in minutes. If Spot Instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.

Required: Yes

Type: Integer

Minimum: 0

Update requires: No interruption