调用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：资源充足
RequestId String D9DD3AF8-1F91-4075-8669-55D10E45D9B1

请求ID。
SupportSpotInstance Boolean false

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

  • false：不支持
  • ture：支持

示例

请求示例

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

正常返回示例

XML格式 

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

JSON格式 

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

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

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