SpotInstanceRequest - Amazon Elastic Compute Cloud

SpotInstanceRequest

Describes a Spot Instance request.

Contents

actualBlockHourlyPrice

Deprecated.

Type: String

Required: No

availabilityZoneGroup

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.

Type: String

Required: No

blockDurationMinutes

Deprecated.

Type: Integer

Required: No

createTime

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

Type: Timestamp

Required: No

fault

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

Type: SpotInstanceStateFault object

Required: No

instanceId

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

Type: String

Required: No

instanceInterruptionBehavior

The behavior when a Spot Instance is interrupted.

Type: String

Valid Values: hibernate | stop | terminate

Required: No

launchedAvailabilityZone

The Availability Zone in which the request is launched.

Type: String

Required: No

launchGroup

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

Type: String

Required: No

launchSpecification

Additional information for launching instances.

Type: LaunchSpecification object

Required: No

productDescription

The product description associated with the Spot Instance.

Type: String

Valid Values: Linux/UNIX | Linux/UNIX (Amazon VPC) | Windows | Windows (Amazon VPC)

Required: No

spotInstanceRequestId

The ID of the Spot Instance request.

Type: String

Required: No

spotPrice

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.

Important

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

Type: String

Required: No

state

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.

Type: String

Valid Values: open | active | closed | cancelled | failed

Required: No

status

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

Type: SpotInstanceStatus object

Required: No

tagSet

Any tags assigned to the resource.

Type: Array of Tag objects

Required: No

type

The Spot Instance request type.

Type: String

Valid Values: one-time | persistent

Required: No

validFrom

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.

Type: Timestamp

Required: No

validUntil

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.

Type: Timestamp

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: