ListPreferredEcsTypes - API Reference| Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	ListPreferredEcsTypes	The operation that you want to perform. Set the value to ListPreferredEcsTypes
ZoneId	String	Yes	cn-hangzhou-b	The ID of the zone.
SpotStrategy	String	No	NoSpot	The bidding policy of the ECS instance. Valid values: NoSpot: The instance is created as a regular pay-as-you-go instance. SpotWithPriceLimit: The instance to be created is a preemptible instance with a user-defined maximum hourly price. SpotAsPriceGo: The instance is a preemptible instance whose price is based on the current market price.
InstanceChargeType	String	No	PostPaid	The billing method of the ECS instance. Valid values: PostPaid: pay-as-you-go PrePaid: subscription

Response parameters


Parameter	Type	Example	Description
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE73368	The ID of the request.
Series	Array of SeriesInfo		The list of recommended ECS instances. Each SeriesInfo element contains the recommended ECS instance types for various nodes of the E-HPC cluster.
SeriesInfo
Roles	Struct		The recommended ECS instance types for various nodes of the E-HPC cluster.
Compute	List	[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]	The list of recommended ECS instance types for compute nodes.
Login	List	[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]	The list of recommended ECS instance types for logon nodes.
Manager	List	[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]	The list of recommended ECS instance types for management nodes.
SeriesId	String	All	The ID of the ECS instance series. Valid values: HighCompute: high computing HighMem: high storage GPU All: all options.
SeriesName	String	SeriesAll	The name of the instance series. Valid values: SeriesHighCompute SeriesHighMem SeriesGPU SeriesAll
SupportSpotInstance	Boolean	true	Indicates whether spot instances are supported.

Examples

Sample requests

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListPreferredEcsTypes
&ZoneId=cn-hangzhou-b
&<Common request parameters>

Sample success responses

XML format

<ListPreferredEcsTypesResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <SupportSpotInstance>true</SupportSpotInstance>
      <Series>
            <SeriesInfo>
                  <SeriesName>SeriesAll</SeriesName>
                  <SeriesId>All</SeriesId>
                  <Roles>
                        <Login>
                              <InstanceTypeId>ecs.sn1ne.2xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.sn1ne.4xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.n1.tiny</InstanceTypeId>
                        </Login>
                        <Manager>
                              <InstanceTypeId>ecs.sn1ne.2xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.sn1ne.4xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.n1.tiny</InstanceTypeId>
                        </Manager>
                        <Compute>
                              <InstanceTypeId>ecs.sn1ne.2xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.sn1ne.4xlarge</InstanceTypeId>
                              <InstanceTypeId>ecs.n1.tiny</InstanceTypeId>
                        </Compute>
                  </Roles>
            </SeriesInfo>
      </Series>
</ListPreferredEcsTypesResponse>

JSON format

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "SupportSpotInstance": true,
    "Series": {
        "SeriesInfo": [
            {
                "SeriesName": "SeriesAll",
                "SeriesId": "All",
                "Roles": {
                    "Login": {
                        "InstanceTypeId": [ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
                    },
                    "Manager": {
                        "InstanceTypeId": [ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
                    },
                    "Compute": {
                        "InstanceTypeId": [ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
                    }
                }
            }
        ]
    }
}

Error codes


HttpCode	Error code	Error message	Description
503	ServiceUnavailable	The request has failed due to a temporary failure of the server	The error message returned because the request has failed. The server is temporarily unavailable.

For a list of error codes, visit the API Error Center.