AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Describes a Spot Instance request.

Inheritance Hierarchy

System.Object
  Amazon.EC2.Model.SpotInstanceRequest

Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public class SpotInstanceRequest

The SpotInstanceRequest type exposes the following members

Constructors

NameDescription
Public Method SpotInstanceRequest()

Properties

NameTypeDescription
Public Property ActualBlockHourlyPrice System.String

Gets and sets the property ActualBlockHourlyPrice.

Deprecated.

Public Property AvailabilityZoneGroup System.String

Gets and sets the property 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.

Public Property BlockDurationMinutes System.Int32

Gets and sets the property BlockDurationMinutes.

Deprecated.

Public Property CreateTime System.DateTime

Gets and sets the property CreateTime.

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

Public Property Fault Amazon.EC2.Model.SpotInstanceStateFault

Gets and sets the property Fault.

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

Public Property InstanceId System.String

Gets and sets the property InstanceId.

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

Public Property InstanceInterruptionBehavior Amazon.EC2.InstanceInterruptionBehavior

Gets and sets the property InstanceInterruptionBehavior.

The behavior when a Spot Instance is interrupted.

Public Property LaunchedAvailabilityZone System.String

Gets and sets the property LaunchedAvailabilityZone.

The Availability Zone in which the request is launched.

Public Property LaunchGroup System.String

Gets and sets the property LaunchGroup.

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

Public Property LaunchSpecification Amazon.EC2.Model.LaunchSpecification

Gets and sets the property LaunchSpecification.

Additional information for launching instances.

Public Property ProductDescription Amazon.EC2.RIProductDescription

Gets and sets the property ProductDescription.

The product description associated with the Spot Instance.

Public Property SpotInstanceRequestId System.String

Gets and sets the property SpotInstanceRequestId.

The ID of the Spot Instance request.

Public Property SpotPrice System.String

Gets and sets the property 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.

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

Public Property State Amazon.EC2.SpotInstanceState

Gets and sets the property 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 for Linux Instances.

Public Property Status Amazon.EC2.Model.SpotInstanceStatus

Gets and sets the property Status.

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

Public Property Tags System.Collections.Generic.List<Amazon.EC2.Model.Tag>

Gets and sets the property Tags.

Any tags assigned to the resource.

Public Property Type Amazon.EC2.SpotInstanceType

Gets and sets the property Type.

The Spot Instance request type.

Public Property ValidFrom System.DateTime

Gets and sets the property 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.

Public Property ValidUntil System.DateTime

Gets and sets the property 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.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5