全部产品
云市场

ListAvailableEcsTypes

更新时间:2019-09-24 16:14:20

查询云服务器ECS可用的实例规格资源。

描述

查询某一可用区中所有可用的ECS实例规格详情。

请求参数

名称 类型 是否必需 默认值 描述
Action String - 操作接口名,系统规定参数,取值:ListAvailableEcsTypes
RegionId String - 地域 ID
ZoneId String - 可用区 ID。
SpotStrategy String NoSpot 可选项:NoSpotSpotWithPriceLimitSpotAsPriceGo。具体含义请参考 ECS CreateInstance 接口同名参数。
InstanceChargeType String PostPaid ECS 实例的付费类型,PostPaid:按量付费,PrePaid:包年包月。具体含义请参考 ECS CreateInstance 接口同名参数。
ShowSoldOut String - 显示实例规格是否卖完。

返回参数

公共参数外返回如下结果:

名称 类型 描述
SupportSpotInstance Boolean 是否支持竞价实例。
InstanceTypeFamilies Array< InstanceTypeFamilyInfo> 实例规格所属的规格族。详细字段内容请看下面说明。

其中, InstanceTypeFamilyInfo 结构的格式如下:

名称 类型 描述
Generation String 实例规格族系列。
InstanceTypeFamilyId String 实例规格所属的规格族ID。更多详情,请参见 实例规格族
Types Array< TypesInfo> 规格列表。

其中, TypesInfo 结构的格式如下:

名称 类型 描述
CpuCoreCount integer vCPU内核数目。
EniQuantity integer 实例规格支持网卡数量。
GPUAmount integer 实例规格附带GPU数量。
GPUSpec integer 实例规格附带GPU类型 。
InstanceTypeId String 实例规格ID。
MemorySize integer 内存大小,单位GiB。
Status String 实例状态。
InstanceBandwidthRx integer 内网入方向带宽限制,单位为kbps。
InstanceBandwidthTx integer 内网出方向带宽限制,单位为kbps。
InstancePpsRx integer 内网入方向PPS限制。
InstancePpsTx integer 内网出方向PPS限制。

示例

请求示例

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

返回示例

XML格式

  1. <ListAvailableEcsTypesResponse>
  2. <InstanceTypeFamilies>
  3. <InstanceTypeFamilyInfo>
  4. <Types>
  5. <TypesInfo>
  6. <CpuCoreCount>4</CpuCoreCount>
  7. <InstanceBandwidthRx>819200</InstanceBandwidthRx>
  8. <EniQuantity>2</EniQuantity>
  9. <InstancePpsRx>150000</InstancePpsRx>
  10. <InstanceTypeId>ecs.n4.xlarge</InstanceTypeId>
  11. <InstanceBandwidthTx>819200</InstanceBandwidthTx>
  12. <GPUSpec></GPUSpec>
  13. <MemorySize>8</MemorySize>
  14. <GPUAmount>0</GPUAmount>
  15. <InstancePpsTx>150000</InstancePpsTx>
  16. </TypesInfo>
  17. </Types>
  18. <InstanceTypeFamilyId>ecs.n4</InstanceTypeFamilyId>
  19. <Generation>ecs-3</Generation>
  20. </InstanceTypeFamilyInfo>
  21. </InstanceTypeFamilies>
  22. <RequestId>D9DD3AF8-1F91-4075-8669-55D10E45D9B1</RequestId>
  23. <SupportSpotInstance>true</SupportSpotInstance>
  24. </ListAvailableEcsTypesResponse>

JSON格式

  1. {
  2. "InstanceTypeFamilies": {
  3. "InstanceTypeFamilyInfo": [
  4. {
  5. "Types": {
  6. "TypesInfo": [
  7. {
  8. "CpuCoreCount": 4,
  9. "InstanceBandwidthRx": 819200,
  10. "EniQuantity": 2,
  11. "InstancePpsRx": 150000,
  12. "InstanceTypeId": "ecs.n4.xlarge",
  13. "InstanceBandwidthTx": 819200,
  14. "GPUSpec": "",
  15. "MemorySize": 8,
  16. "GPUAmount": 0,
  17. "InstancePpsTx": 150000
  18. }
  19. ]
  20. },
  21. "InstanceTypeFamilyId": "ecs.n4",
  22. "Generation": "ecs-3"
  23. }
  24. ]
  25. },
  26. "RequestId": "D9DD3AF8-1F91-4075-8669-55D10E45D9B1",
  27. "SupportSpotInstance": true
  28. }

错误码

查询 E-HPC 接口错误码请访问 错误码。更多错误码,请访问 API 错误中心