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 | terminateRequired: 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 | failedRequired: 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 | persistentRequired: 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
validUntildate 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
validUntildate 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:
