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.

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)

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

    The Availability Zone group.

#block_duration_minutesInteger

The duration for the Spot Instance, in minutes.

Returns:

  • (Integer)

    The duration for the Spot Instance, in minutes.

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

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

#faultTypes::SpotInstanceStateFault

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

Returns:

#instance_idString

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_behaviorString

The behavior when a Spot Instance is interrupted.

Possible values:

  • hibernate
  • stop
  • terminate

Returns:

  • (String)

    The behavior when a Spot Instance is interrupted.

#launch_groupString

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

Returns:

  • (String)

    The instance launch group.

#launch_specificationTypes::LaunchSpecification

Additional information for launching instances.

Returns:

#launched_availability_zoneString

The Availability Zone in which the request is launched.

Returns:

  • (String)

    The Availability Zone in which the request is launched.

#product_descriptionString

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_idString

The ID of the Spot Instance request.

Returns:

  • (String)

    The ID of the Spot Instance request.

#spot_priceString

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.

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

    The state of the Spot Instance request.

#statusTypes::SpotInstanceStatus

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

Returns:

#tagsArray<Types::Tag>

Any tags assigned to the resource.

Returns:

  • (Array<Types::Tag>)

    Any tags assigned to the resource.

#typeString

The Spot Instance request type.

Possible values:

  • one-time
  • persistent

Returns:

  • (String)

    The Spot Instance request type.

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

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

#valid_untilTime

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