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

Class: Aws::EC2::Types::SpotInstanceRequest

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

Overview

Describes a Spot Instance request.

Instance Attribute Summary collapse

Instance Attribute Details

#actual_block_hourly_priceString

If you specified a duration and your Spot Instance request was fulfilled, this is the fixed hourly price in effect for the Spot Instance while it runs.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#availability_zone_groupString

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#block_duration_minutesInteger

The duration for the Spot Instance, in minutes.

Returns:

  • (Integer)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#create_timeTime

The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

Returns:

  • (Time)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#faultTypes::SpotInstanceStateFault

The fault codes for the Spot Instance request, if any.



36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#instance_idString

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#instance_interruption_behaviorString

The behavior when a Spot Instance is interrupted.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#launch_groupString

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#launch_specificationTypes::LaunchSpecification

Additional information for launching instances.



36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#launched_availability_zoneString

The Availability Zone in which the request is launched.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#product_descriptionString

The product description associated with the Spot Instance.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#spot_instance_request_idString

The ID of the Spot Instance request.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#spot_priceString

The maximum price per hour that you are willing to pay for a Spot Instance.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#stateString

The state of the Spot Instance request. Spot status information helps track your Spot Instance requests. For more information, see Spot Status in the Amazon EC2 User Guide for Linux Instances.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#statusTypes::SpotInstanceStatus

The status code and status message describing the Spot Instance request.



36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#tagsArray<Types::Tag>

Any tags assigned to the resource.

Returns:



36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#typeString

The Spot Instance request type.

Returns:

  • (String)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#valid_fromTime

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

Returns:

  • (Time)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end

#valid_untilTime

The end date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). If this is a one-time request, it remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date is reached. The default end date is 7 days from the current date.

Returns:

  • (Time)


36621
36622
36623
36624
36625
36626
36627
36628
36629
36630
36631
36632
36633
36634
36635
36636
36637
36638
36639
36640
36641
36642
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36621

class SpotInstanceRequest < Struct.new(
  :actual_block_hourly_price,
  :availability_zone_group,
  :block_duration_minutes,
  :create_time,
  :fault,
  :instance_id,
  :launch_group,
  :launch_specification,
  :launched_availability_zone,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  include Aws::Structure
end