文档

ListAvailableEcsTypes - 查询可用的ECS实例规格资源

更新时间:

调用ListAvailableEcsTypes查询可用的ECS实例规格资源。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ehpc:ListAvailableEcsTypesRead
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ZoneIdstring

可用区 ID。

cn-hangzhou-b
SpotStrategystring

ECS 实例抢占策略。取值范围:

  • NoSpot:按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的抢占式实例。
NoSpot
InstanceChargeTypestring

ECS 实例的付费类型。取值范围:

  • PostPaid:按量付费
  • PrePaid:包年包月
PostPaid
ShowSoldOutboolean

是否显示 ECS 实例已售罄。取值范围:

  • false:未售罄
  • true:已售罄

默认值:false

false

返回参数

名称类型描述示例值
object
SupportSpotInstanceboolean

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

  • false:不支持
  • true:支持
false
RequestIdstring

请求 ID。

D9DD3AF8-1F91-4075-8669-55D10E45****
InstanceTypeFamiliesobject []

实例规格所属的规格族。

Generationstring

实例规格族。

ecs-3
InstanceTypeFamilyIdstring

实例规格所属的规格族 ID。更多详情,请参见实例规格族

ecs.n4
Typesobject []

规格列表。

Statusstring

ECS 实例状态。可能值:

  • SoldOut:资源已售罄
  • Available:资源充足
Available
InstanceTypeIdstring

ECS 实例规格 ID。

ecs.n4.xlarge
InstanceBandwidthRxinteger

内网入方向带宽限制。单位:kbit/s

10240000
GPUSpecstring

ECS 实例安装的 GPU 类型。

NVIDIA V100
InstanceBandwidthTxinteger

内网出方向带宽限制。单位:kbit/s

10240000
InstancePpsRxinteger

内网入方向网络收发包能力。单位:Pps

9000000
InstancePpsTxinteger

内网出方向网络收发包能力。单位:Pps

9000000
GPUAmountinteger

ECS 实例安装的 GPU 数量。

2
CpuCoreCountinteger

vCPU 内核数目。

4
MemorySizeinteger

ECS 实例内存大小。单位:GiB

8
EniQuantityinteger

ECS 实例支持挂载的弹性网卡上限。

2
ZoneIdsarray

可用区 ID 列表。

string

可用区 ID 列表。

cn-hangzhou-b

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe specified parameter %s is invalid.无效的参数:%s
406EcsErrorAn error occurred while calling the ECS API operation.ECS API调用出错
407NotAuthorizedYou are not authorized by RAM for this request.此请求未获得RAM授权
500UnknownErrorAn unknown error occurred.未知错误
503ServiceUnavailableThe request has failed due to a temporary failure of the server请求失败,服务暂时不可用

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