调用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 请求失败,服务暂时不可用

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