调用ListAvailableEcsTypes查询可用的ECS实例规格资源。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListAvailableEcsTypes

系统规定参数。取值：ListAvailableEcsTypes
ZoneId String 否 cn-hangzhou-b

可用区ID。
SpotStrategy String 否 NoSpot

ECS实例抢占策略。取值范围：

  • NoSpot：按量付费实例。
  • SpotWithPriceLimit：设置上限价格的抢占式实例。
  • SpotAsPriceGo：系统自动出价，跟随当前市场实际价格的抢占式实例。
InstanceChargeType String 否 PostPaid

ECS实例的付费类型。取值范围：

  • PostPaid：按量付费
  • PrePaid：包年包月
ShowSoldOut Boolean 否 false

是否显示ECS实例已售罄。取值范围：

  • false：未售罄
  • true：已售罄

默认值：false

返回数据

名称 类型 示例值 描述
InstanceTypeFamilies Array of InstanceTypeFamilyInfo

实例规格所属的规格族。
InstanceTypeFamilyInfo
Generation String ecs-3

实例规格族。
InstanceTypeFamilyId String ecs.n4

实例规格所属的规格族ID。更多详情，请参见实例规格族。

Types Array of TypesInfo

规格列表。
TypesInfo
CpuCoreCount Integer 4

vCPU内核数目。
EniQuantity Integer 2

ECS实例支持挂载的弹性网卡上限。
GPUAmount Integer 2

ECS实例安装的GPU数量。
GPUSpec String NVIDIA V100

ECS实例安装的GPU类型。
InstanceBandwidthRx Integer 10240000

内网入方向带宽限制。单位：kbit/s
InstanceBandwidthTx Integer 10240000

内网出方向带宽限制。单位：kbit/s
InstancePpsRx Integer 9000000

内网入方向网络收发包能力。单位：Pps
InstancePpsTx Integer 9000000

内网出方向网络收发包能力。单位：Pps
InstanceTypeId String ecs.n4.xlarge

ECS实例规格ID。
MemorySize Integer 8

ECS实例内存大小。单位：GiB
Status String Available

ECS实例状态。可能值：

  • SoldOut：资源已售罄
  • Available：资源充足
ZoneIds List cn-hangzhou-b

可用区ID列表。
RequestId String D9DD3AF8-1F91-4075-8669-55D10E45****

请求ID。
SupportSpotInstance Boolean false

是否支持抢占式实例。可能值：

  • false：不支持
  • true：支持

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListAvailableEcsTypes
&ZoneId=cn-hangzhou-b
&<公共请求参数>

正常返回示例

XML格式 

<ListAvailableEcsTypesResponse>
  <SupportSpotInstance>false</SupportSpotInstance>
  <RequestId>D9DD3AF8-1F91-4075-8669-55D10E45****</RequestId>
  <InstanceTypeFamilies>
        <InstanceTypeFamilyInfo>
              <InstanceTypeFamilyId>ecs.n4</InstanceTypeFamilyId>
              <Generation>ecs-3</Generation>
              <Types>
                    <TypesInfo>
                          <Status>Available</Status>
                          <InstancePpsTx>9000000</InstancePpsTx>
                          <MemorySize>8</MemorySize>
                          <GPUSpec>NVIDIA V100</GPUSpec>
                          <CpuCoreCount>4</CpuCoreCount>
                          <InstancePpsRx>9000000</InstancePpsRx>
                          <InstanceTypeId>ecs.n4.xlarge</InstanceTypeId>
                          <EniQuantity>2</EniQuantity>
                          <InstanceBandwidthRx>10240000</InstanceBandwidthRx>
                          <GPUAmount>2</GPUAmount>
                          <InstanceBandwidthTx>10240000</InstanceBandwidthTx>
                          <ZoneIds>
                                <ZoneId>cn-hangzhou-b</ZoneId>
                          </ZoneIds>
                    </TypesInfo>
              </Types>
        </InstanceTypeFamilyInfo>
  </InstanceTypeFamilies>
</ListAvailableEcsTypesResponse>

JSON格式 

{
    "SupportSpotInstance": false,
    "RequestId": "D9DD3AF8-1F91-4075-8669-55D10E45****",
    "InstanceTypeFamilies": {
        "InstanceTypeFamilyInfo": {
            "InstanceTypeFamilyId": "ecs.n4",
            "Generation": "ecs-3",
            "Types": {
                "TypesInfo": {
                    "Status": "Available",
                    "InstancePpsTx": 9000000,
                    "MemorySize": 8,
                    "GPUSpec": "NVIDIA V100",
                    "CpuCoreCount": 4,
                    "InstancePpsRx": 9000000,
                    "InstanceTypeId": "ecs.n4.xlarge",
                    "EniQuantity": 2,
                    "InstanceBandwidthRx": 10240000,
                    "GPUAmount": 2,
                    "InstanceBandwidthTx": 10240000,
                    "ZoneIds": {
                        "ZoneId": "cn-hangzhou-b"
                    }
                }
            }
        }
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The specified parameter %s is invalid. 无效的参数: %s
407 NotAuthorized You are not authorized by RAM for this request. 此请求未获得RAM授权
406 EcsError An error occurred while calling the ECS API operation. ECS API调用出错
500 UnknownError An unknown error occurred. 未知错误
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

访问错误中心查看更多错误码。