ListAvailableEcsTypes_软件和镜像管理_API 参考_弹性高性能计算E-HPC-阿里云

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

描述

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

请求参数

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

返回参数

除公共参数外返回如下结果：

名称	类型	描述
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限制。

示例

请求示例

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

返回示例

XML格式

<ListAvailableEcsTypesResponse>
    <InstanceTypeFamilies>
        <InstanceTypeFamilyInfo>
            <Types>
                <TypesInfo>
                    <CpuCoreCount>4</CpuCoreCount>
                    <InstanceBandwidthRx>819200</InstanceBandwidthRx>
                    <EniQuantity>2</EniQuantity>
                    <InstancePpsRx>150000</InstancePpsRx>
                    <InstanceTypeId>ecs.n4.xlarge</InstanceTypeId>
                    <InstanceBandwidthTx>819200</InstanceBandwidthTx>
                    <GPUSpec></GPUSpec>
                    <MemorySize>8</MemorySize>
                    <GPUAmount>0</GPUAmount>
                    <InstancePpsTx>150000</InstancePpsTx>
                </TypesInfo>
            </Types>
            <InstanceTypeFamilyId>ecs.n4</InstanceTypeFamilyId>
            <Generation>ecs-3</Generation>
        </InstanceTypeFamilyInfo>
    </InstanceTypeFamilies>
    <RequestId>D9DD3AF8-1F91-4075-8669-55D10E45D9B1</RequestId>
    <SupportSpotInstance>true</SupportSpotInstance>
</ListAvailableEcsTypesResponse>

JSON格式

{
  "InstanceTypeFamilies": {
    "InstanceTypeFamilyInfo": [
      {
        "Types": {
          "TypesInfo": [
            {
              "CpuCoreCount": 4,
              "InstanceBandwidthRx": 819200,
              "EniQuantity": 2,
              "InstancePpsRx": 150000,
              "InstanceTypeId": "ecs.n4.xlarge",
              "InstanceBandwidthTx": 819200,
              "GPUSpec": "",
              "MemorySize": 8,
              "GPUAmount": 0,
              "InstancePpsTx": 150000
            }
          ]
        },
        "InstanceTypeFamilyId": "ecs.n4",
        "Generation": "ecs-3"
      }
    ]
  },
  "RequestId": "D9DD3AF8-1F91-4075-8669-55D10E45D9B1",
    "SupportSpotInstance": true
}

错误码

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