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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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.



28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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.



28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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.



28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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:



28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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)


28986
28987
28988
28989
28990
28991
28992
28993
28994
28995
28996
28997
28998
28999
29000
29001
29002
29003
29004
29005
29006
29007
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 28986

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