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

Inherits:

Struct

Object
Struct
Aws::EC2::Types::SpotInstanceRequest

show all

Defined in:: gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb

Overview

Describes a Spot Instance request.

Constant Summary collapse

SENSITIVE =

[]

Instance Attribute Summary collapse

#actual_block_hourly_price ⇒ String
Deprecated.
#availability_zone_group ⇒ String
The Availability Zone group.
#block_duration_minutes ⇒ Integer
Deprecated.
#create_time ⇒ Time
The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).
#fault ⇒ Types::SpotInstanceStateFault
The fault codes for the Spot Instance request, if any.
#instance_id ⇒ String
The instance ID, if an instance has been launched to fulfill the Spot Instance request.
#instance_interruption_behavior ⇒ String
The behavior when a Spot Instance is interrupted.
#launch_group ⇒ String
The instance launch group.
#launch_specification ⇒ Types::LaunchSpecification
Additional information for launching instances.
#launched_availability_zone ⇒ String
The Availability Zone in which the request is launched.
#launched_availability_zone_id ⇒ String
The ID of the Availability Zone in which the request is launched.
#product_description ⇒ String
The product description associated with the Spot Instance.
#spot_instance_request_id ⇒ String
The ID of the Spot Instance request.
#spot_price ⇒ String
The maximum price per unit hour that you are willing to pay for a Spot Instance.
#state ⇒ String
The state of the Spot Instance request.
#status ⇒ Types::SpotInstanceStatus
The status code and status message describing the Spot Instance request.
#tags ⇒ Array<Types::Tag>
Any tags assigned to the resource.
#type ⇒ String
The Spot Instance request type.
#valid_from ⇒ Time
The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).
#valid_until ⇒ Time
The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ).

Instance Attribute Details

#actual_block_hourly_price ⇒ `String`

Deprecated.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#availability_zone_group ⇒ `String`

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)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#block_duration_minutes ⇒ `Integer`

Deprecated.

Returns:

(Integer)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#create_time ⇒ `Time`

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

Returns:

(Time)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#fault ⇒ `Types::SpotInstanceStateFault`

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

Returns:

(Types::SpotInstanceStateFault)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#instance_id ⇒ `String`

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

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#instance_interruption_behavior ⇒ `String`

The behavior when a Spot Instance is interrupted.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#launch_group ⇒ `String`

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

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#launch_specification ⇒ `Types::LaunchSpecification`

Additional information for launching instances.

Returns:

(Types::LaunchSpecification)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#launched_availability_zone ⇒ `String`

The Availability Zone in which the request is launched.

Either launchedAvailabilityZone or launchedAvailabilityZoneId can be specified, but not both

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#launched_availability_zone_id ⇒ `String`

The ID of the Availability Zone in which the request is launched.

Either launchedAvailabilityZone or launchedAvailabilityZoneId can be specified, but not both

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#product_description ⇒ `String`

The product description associated with the Spot Instance.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#spot_instance_request_id ⇒ `String`

The ID of the Spot Instance request.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#spot_price ⇒ `String`

The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.

If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#state ⇒ `String`

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

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#status ⇒ `Types::SpotInstanceStatus`

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

Returns:

(Types::SpotInstanceStatus)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ `Array<Types::Tag>`

Any tags assigned to the resource.

Returns:

(Array<Types::Tag>)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#type ⇒ `String`

The Spot Instance request type.

Returns:

(String)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#valid_from ⇒ `Time`

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)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

#valid_until ⇒ `Time`

The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ).

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, the request remains active until all instances launch, the request is canceled, or the validUntil date and time is reached. By default, the request is valid for 7 days from the date the request was created.

Returns:

(Time)

# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 78639

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,
  :launched_availability_zone_id,
  :product_description,
  :spot_instance_request_id,
  :spot_price,
  :state,
  :status,
  :tags,
  :type,
  :valid_from,
  :valid_until,
  :instance_interruption_behavior)
  SENSITIVE = []
  include Aws::Structure
end

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

Overview

Constant Summary collapse

Instance Attribute Summary collapse

Instance Attribute Details

#actual_block_hourly_price ⇒ String

#availability_zone_group ⇒ String

#block_duration_minutes ⇒ Integer

#create_time ⇒ Time

#fault ⇒ Types::SpotInstanceStateFault

#instance_id ⇒ String

#instance_interruption_behavior ⇒ String

#launch_group ⇒ String

#launch_specification ⇒ Types::LaunchSpecification

#launched_availability_zone ⇒ String

#launched_availability_zone_id ⇒ String

#product_description ⇒ String

#spot_instance_request_id ⇒ String

#spot_price ⇒ String

#state ⇒ String

#status ⇒ Types::SpotInstanceStatus

#tags ⇒ Array<Types::Tag>

#type ⇒ String

#valid_from ⇒ Time

#valid_until ⇒ Time

#actual_block_hourly_price ⇒ `String`

#availability_zone_group ⇒ `String`

#block_duration_minutes ⇒ `Integer`

#create_time ⇒ `Time`

#fault ⇒ `Types::SpotInstanceStateFault`

#instance_id ⇒ `String`

#instance_interruption_behavior ⇒ `String`

#launch_group ⇒ `String`

#launch_specification ⇒ `Types::LaunchSpecification`

#launched_availability_zone ⇒ `String`

#launched_availability_zone_id ⇒ `String`

#product_description ⇒ `String`

#spot_instance_request_id ⇒ `String`

#spot_price ⇒ `String`

#state ⇒ `String`

#status ⇒ `Types::SpotInstanceStatus`

#tags ⇒ `Array<Types::Tag>`

#type ⇒ `String`

#valid_from ⇒ `Time`

#valid_until ⇒ `Time`