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.

Container for the parameters to the GetSpotPlacementScores operation. Calculates the Spot placement score for a Region or Availability Zone based on the specified target capacity and compute requirements.

You can specify your compute requirements either by using InstanceRequirementsWithMetadata and letting Amazon EC2 choose the optimal instance types to fulfill your Spot request, or you can specify the instance types by using InstanceTypes.

For more information, see Spot placement score in the Amazon EC2 User Guide.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.GetSpotPlacementScoresRequest

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

Syntax

C#
public class GetSpotPlacementScoresRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The GetSpotPlacementScoresRequest type exposes the following members

Constructors

Properties

NameTypeDescription
Public Property InstanceRequirementsWithMetadata Amazon.EC2.Model.InstanceRequirementsWithMetadataRequest

Gets and sets the property InstanceRequirementsWithMetadata.

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with those attributes.

If you specify InstanceRequirementsWithMetadata, you can't specify InstanceTypes.

Public Property InstanceTypes System.Collections.Generic.List<System.String>

Gets and sets the property InstanceTypes.

The instance types. We recommend that you specify at least three instance types. If you specify one or two instance types, or specify variations of a single instance type (for example, an m3.xlarge with and without instance storage), the returned placement score will always be low.

If you specify InstanceTypes, you can't specify InstanceRequirementsWithMetadata.

Public Property MaxResults System.Int32

Gets and sets the property MaxResults.

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.

Public Property NextToken System.String

Gets and sets the property NextToken.

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

Public Property RegionNames System.Collections.Generic.List<System.String>

Gets and sets the property RegionNames.

The Regions used to narrow down the list of Regions to be scored. Enter the Region code, for example, us-east-1.

Public Property SingleAvailabilityZone System.Boolean

Gets and sets the property SingleAvailabilityZone.

Specify true so that the response returns a list of scored Availability Zones. Otherwise, the response returns a list of scored Regions.

A list of scored Availability Zones is useful if you want to launch all of your Spot capacity into a single Availability Zone.

Public Property TargetCapacity System.Int32

Gets and sets the property TargetCapacity.

The target capacity.

Public Property TargetCapacityUnitType Amazon.EC2.TargetCapacityUnitType

Gets and sets the property TargetCapacityUnitType.

The unit for the target capacity.

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