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

调试

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

请求参数

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

操作接口名,系统规定参数,取值:ListAvailableEcsTypes

ZoneId String cn-hangzho-b

可用区ID。

SpotStrategy String NoSpot

可选项:NoSpot、SpotWithPriceLimit 或 SpotAsPriceGo。具体含义请参考 ECS CreateInstance接口同名参数。

InstanceChargeType String PostPaid

ECS 实例的付费类型:

  • PostPaid:按量付费
  • PrePaid:包年包月
ShowSoldOut Boolean 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

实例规格支持网卡数量。

GPUAmount Integer 0

实例规格附带GPU数量。

GPUSpec String 0

实例规格附带GPU类型 。

InstanceBandwidthRx Integer 819200

内网入方向带宽限制,单位为kbps。

InstanceBandwidthTx Integer 819200

内网出方向带宽限制,单位为kbps。

InstancePpsRx Integer 150000

内网入方向PPS限制。

InstancePpsTx Integer 150000

内网入方向PPS限制。

InstanceTypeId String ecs.n4.xlarge

实例规格ID。

MemorySize Integer 8

内存大小,单位GiB。

Status String Available

实例状态。

RequestId String D9DD3AF8-1F91-4075-8669-55D10E45D9B1

请求ID。

SupportSpotInstance Boolean false

是否支持竞价实例。

示例

请求示例

http(s)://[Endpoint]/?Action=ListAvailableEcsTypes
&ZoneId=cn-hangzho-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
}

错误码

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

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