Class: Aws::EC2::Types::SpotMarketOptions

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb

Overview

Note:

When making an API call, you may pass SpotMarketOptions data as a hash:

{
  max_price: "String",
  spot_instance_type: "one-time", # accepts one-time, persistent
  block_duration_minutes: 1,
  valid_until: Time.now,
  instance_interruption_behavior: "hibernate", # accepts hibernate, stop, terminate
}

The options for Spot Instances.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#block_duration_minutesInteger

The required duration for the Spot Instances (also known as Spot blocks), in minutes. This value must be a multiple of 60 (60, 120, 180, 240, 300, or 360).

The duration period starts as soon as your Spot Instance receives its instance ID. At the end of the duration period, 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.

You can't specify an Availability Zone group or a launch group if you specify a duration.

New accounts or accounts with no previous billing history with AWS are not eligible for Spot Instances with a defined duration (also known as Spot blocks).

Returns:

  • (Integer)


47506
47507
47508
47509
47510
47511
47512
47513
47514
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 47506

class SpotMarketOptions < Struct.new(
  :max_price,
  :spot_instance_type,
  :block_duration_minutes,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#instance_interruption_behaviorString

The behavior when a Spot Instance is interrupted. The default is terminate.

Returns:

  • (String)


47506
47507
47508
47509
47510
47511
47512
47513
47514
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 47506

class SpotMarketOptions < Struct.new(
  :max_price,
  :spot_instance_type,
  :block_duration_minutes,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#max_priceString

The maximum hourly price you're willing to pay for the Spot Instances. The default is the On-Demand price.

Returns:

  • (String)


47506
47507
47508
47509
47510
47511
47512
47513
47514
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 47506

class SpotMarketOptions < Struct.new(
  :max_price,
  :spot_instance_type,
  :block_duration_minutes,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#spot_instance_typeString

The Spot Instance request type. For RunInstances, persistent Spot Instance requests are only supported when InstanceInterruptionBehavior is set to either hibernate or stop.

Returns:

  • (String)


47506
47507
47508
47509
47510
47511
47512
47513
47514
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 47506

class SpotMarketOptions < Struct.new(
  :max_price,
  :spot_instance_type,
  :block_duration_minutes,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#valid_untilTime

The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ). Supported only for persistent requests.

  • 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.

Returns:

  • (Time)


47506
47507
47508
47509
47510
47511
47512
47513
47514
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 47506

class SpotMarketOptions < Struct.new(
  :max_price,
  :spot_instance_type,
  :block_duration_minutes,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end