调用ListEcsSpecs,获取ECS规格列表。

调试

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

请求语法

GET /api/v1/ecsSpecs?AcceleratorTypeEquals=String HTTP/1.1
Content-Type:application/json

请求参数

表 1. 请求Query参数
参数名称 类型 是否必选 示例 说明
AcceleratorTypeEquals String cpu

资源或规格类型

  • cpu
  • gpu

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "String",
  "EcsSpecs" : [ {
    "InstanceType" : "String",
    "Cpu" : Long,
    "Gpu" : Long,
    "MemoryInGiB" : Long,
    "SystemDiskCategory" : "String",
    "SystemDiskSizeInGiB" : Long,
    "GpuType" : "String"
  } ],
  "TotalCount" : Long
}

响应参数

表 2. 响应Body参数
参数名称 类型 示例 说明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID

EcsSpecs Array of EcsSpec

ECS规格列表

TotalCount Long 10

符合要求的ECS规格数量

获取ECS规格列表

GET /api/v1/ecsSpecs?AcceleratorTypeEquals=cpu HTTP/1.1
Host:pai-dsw.aliyuncs.com
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<EcsSpecs>
    <InstanceType>ecs.gn6e-c12g1.3xlarge</InstanceType>
    <Cpu>1</Cpu>
    <Gpu>1</Gpu>
    <MemoryInGiB>100</MemoryInGiB>
    <SystemDiskCategory>ssd</SystemDiskCategory>
    <SystemDiskSizeInGiB>10000</SystemDiskSizeInGiB>
    <GpuType>v100</GpuType>
</EcsSpecs>
<TotalCount>10</TotalCount>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "EcsSpecs" : [ {
    "InstanceType" : "ecs.gn6e-c12g1.3xlarge",
    "Cpu" : 1,
    "Gpu" : 1,
    "MemoryInGiB" : 100,
    "SystemDiskCategory" : "ssd",
    "SystemDiskSizeInGiB" : 10000,
    "GpuType" : "v100"
  } ],
  "TotalCount" : 10
}

错误码

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

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK,帮助您快速通过API集成阿里云的产品和服务,推荐您使用SDK调用API,已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索,可视化调试API,在线命令行工具,同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具,可通过命令方式同时管理多个阿里云产品和服务,简单快捷,是您上云好帮手。