Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

SpotInstanceRequest

Describes a Spot instance request.

Contents

actualBlockHourlyPrice

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.

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

The duration for the Spot instance, in minutes.

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

launchedAvailabilityZone

The Availability Zone in which the bid 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 hourly price (bid) for the Spot instance launched to fulfill the request.

Type: String

Required: No

state

The state of the Spot instance request. Spot bid status information can help you track your Spot instance requests. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud 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 (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.

Type: Timestamp

Required: No

See Also

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

On this page: