You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::EMR::Types::SpotProvisioningSpecification

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing SpotProvisioningSpecification as input to an Aws::Client method, you can use a vanilla Hash:

{
  timeout_duration_minutes: 1, # required
  timeout_action: "SWITCH_TO_ON_DEMAND", # required, accepts SWITCH_TO_ON_DEMAND, TERMINATE_CLUSTER
  block_duration_minutes: 1,
  allocation_strategy: "capacity-optimized", # accepts capacity-optimized
}

The launch specification for Spot instances in the instance fleet, which determines the defined duration, provisioning timeout behavior, and allocation strategy.

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions. Spot instance allocation strategy is available in Amazon EMR version 5.12.1 and later.

Returned by:

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#allocation_strategy ⇒ String

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.

Possible values:

  • capacity-optimized

Returns:

  • (String) —

    Specifies the strategy to use in launching Spot instance fleets.

#block_duration_minutes ⇒ Integer

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.

Returns:

  • (Integer) —

    The defined duration for Spot instances (also known as Spot blocks) in minutes.

#timeout_action ⇒ String

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.

Possible values:

  • SWITCH_TO_ON_DEMAND
  • TERMINATE_CLUSTER

Returns:

  • (String) —

    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.

#timeout_duration_minutes ⇒ Integer

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.

Returns:

  • (Integer) —

    The spot provisioning timeout period in minutes.