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

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

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

Overview

Describes a Spot Instance request.

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#actual_block_hourly_price ⇒ String

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) —

    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.

#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) —

    The Availability Zone group.

#block_duration_minutes ⇒ Integer

The duration for the Spot Instance, in minutes.

Returns:

  • (Integer) —

    The duration for the Spot Instance, in minutes.

#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) —

    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.

Returns:

#instance_id ⇒ String

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

Returns:

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

Possible values:

  • hibernate
  • stop
  • terminate

Returns:

  • (String) —

    The behavior when a Spot Instance is interrupted.

#launch_group ⇒ String

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

Returns:

  • (String) —

    The instance launch group.

#launch_specification ⇒ Types::LaunchSpecification

Additional information for launching instances.

Returns:

#launched_availability_zone ⇒ String

The Availability Zone in which the request is launched.

Returns:

  • (String) —

    The Availability Zone in which the request is launched.

#product_description ⇒ String

The product description associated with the Spot Instance.

Possible values:

  • Linux/UNIX
  • Linux/UNIX (Amazon VPC)
  • Windows
  • Windows (Amazon VPC)

Returns:

  • (String) —

    The product description associated with the Spot Instance.

#spot_instance_request_id ⇒ String

The ID of the Spot Instance request.

Returns:

  • (String) —

    The ID of the Spot Instance request.

#spot_price ⇒ String

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

Returns:

  • (String) —

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

#state ⇒ String

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) —

    The state of the Spot Instance request.

#status ⇒ Types::SpotInstanceStatus

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

Returns:

#tags ⇒ Array<Types::Tag>

Any tags assigned to the resource.

Returns:

  • (Array<Types::Tag>) —

    Any tags assigned to the resource.

#type ⇒ String

The Spot Instance request type.

Possible values:

  • one-time
  • persistent

Returns:

  • (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). The request becomes active at this date and time.

Returns:

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

  • 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) —

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