文档中心

云服务器

请输入

实例

DescribeInstanceTypes - 查询实例规格列表

调用 DescribeInstanceTypes 接口查询云服务器提供的所有实例规格的信息，也可以查询指定实例规格的信息。

使用说明

该接口仅查询实例规格的配置和性能信息，如果您需要查询具体可用区下可购买的实例规格，请使用DescribeAvailableResource。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeInstanceTypes

要执行的操作，取值：DescribeInstanceTypes。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

ImageId string 可选示例值：image-ydam1k535clzp*****

镜像ID，查询该镜像可创建的实例规格。

InstanceTypeIds.N string[] 可选示例值：InstanceTypeIds.1=ecs.g3i.large&InstanceTypeIds.2=ecs.g1ve.8xlarge

指定查询的实例规格。取值请参见实例规格介绍。

参数 - N：表示实例规格的序号，取值范围：1～100。N大于100时，仅前100个生效。

多个InstanceTypeId 之间用&分隔。

说明

不传则默认查询所有实例规格的信息。

MaxResults integer 可选示例值：10

分页查询时设置的每页行数。

最大值：1000

最小值：1

默认值：10

NextToken string 可选示例值：--

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

InstanceTypes object[] 示例值：--

符合条件的实例规格信息。

AffinityGroupSizes integer[] 示例值：2

亲和组规格。

BaselineCredit long 示例值：20

突发性能实例可以持续稳定地提供的CPU基准性能，由实例规格决定。

Gpu object 示例值：--

GPU规格信息。

GpuDevices object[] 示例值：--

GPU设备信息列表。

Count integer 示例值：4

GPU卡的数量。

Memory object 示例值：--

显存信息。

EncryptedSize integer 示例值：8192

加密内存大小，单位：MiB。取值范围：0 ~ 256 * 1024。

当InstanceTypeFamily取值为ecs.ebmg2t，即安全增强型弹性裸金属实例时分配有加密内存，且最高可设置为256 GiB，其余规格默认为0。

安全增强型弹性裸金属实例正在邀测中，如需试用，请联系客户经理申请。

Size integer 示例值：4096

内存大小，单位：MiB。

ProductName string 示例值：NVIDIA A100

GPU型号。

InitialCredit long 示例值：60

创建突发性能实例时一次性获得的CPU积分，固定为每vCPU 30个积分。

InstanceTypeFamily string 示例值：ecs.g3i

实例规格族。

InstanceTypeId string 示例值：ecs.g3i.large

实例规格。

IsSupportAffinityGroup boolean 示例值：false

实例规格是否支持亲和组。取值：

true：支持。

false：不支持。

IsSupportJumboFrame boolean 示例值：false

实例规格是否支持巨型帧。取值：

true：支持。

false：不支持。

LocalVolumes object[] 示例值：--

实例规格对应的本地盘配置信息。

Count integer 示例值：4

实例挂载的本地盘的数量。

Size integer 示例值：200

实例挂载的本地盘的单盘容量，单位GiB。

VolumeType string 示例值：LOCAL_SSD

本地盘类型，取值：

LOCAL_SSD：SSD本地盘

LOCAL_HDD：HDD本地盘

Memory object 示例值：--

实例规格的内存信息。

EncryptedSize integer 示例值：8192

加密内存大小，单位：MiB。取值范围：0 ~ 256 * 1024。

当InstanceTypeFamily取值为ecs.ebmg2t，即安全增强型弹性裸金属实例时分配有加密内存，且最高可设置为256 GiB，其余规格默认为0。

安全增强型弹性裸金属实例正在邀测中，如需试用，请联系客户经理申请。

Size integer 示例值：4096

内存大小，单位：MiB。

Network object 示例值：--

实例规格的网络信息。

VrdmaCrossS2BandwidthMbps integer 示例值：50

vRdam跨S2交换机限速带宽，单位Mbps。

BaselineBandwidthMbps integer 示例值：2000

网络基准带宽能力（出/入），单位：Mbps。

MaximumBandwidthMbps integer 示例值：2000

网络峰值带宽能力（出/入），单位：Mbps。

说明

如果指定的实例规格不具备突发能力，则MaximumBandwidthMbps的返回值与BaselineBandwidthMbps相同。具有突发能力的实例规格请参见实例规格介绍。

MaximumNetworkInterfaces integer 示例值：8

支持挂载的弹性网卡数量上限。

不同实例规格支持挂载的弹性网卡数量不同，具体请参见实例规格介绍。

MaximumPrivateIpv4AddressesPerNetworkInterface integer 示例值：20

单块弹性网卡的IPv4地址数量上限，具体请参见实例规格介绍。

MaximumQueuesPerNetworkInterface integer 示例值：16

单块弹性网卡最大队列数，包括主网卡及辅助网卡支持的队列数，具体请参见实例规格介绍。

MaximumThroughputKpps integer 示例值：150

网络收发包能力（出+入），单位：Kpps。

Processor object 示例值：--

实例规格的CPU信息。

BaseFrequency float 示例值：2.3

CPU主频，单位：GHz。

Cpus integer 示例值：8

CPU数量。

Model string 示例值：Intel Xeon(Ice Lake) Platinum 8336C

CPU型号。

TurboFrequency float 示例值：3.0

CPU睿频，单位：GHz。

Rdma object 示例值：--

RDMA规格信息。

RdmaNetworkInterfaces integer 示例值：2

RDMA网卡数量。

RdmaProductName string 示例值：Mellanox BlueField3

RDMA网卡型号。

Volume object 示例值：--

实例规格的云盘信息。

MaximumCount integer 示例值：16

支持挂载云盘的数量上限。

取值：各实例规格的云盘数量上限有所不同，具体请参见实例规格介绍，大致如下：

4：突发性能实例t2支持的云盘数量上限。

15：除g1ie/c1ie/r1ie之外的第一代实例支持的云盘数量上限。

16：g1ie/c1ie/r1ie以及二代、三代实例支持的云盘数量上限。

SupportedVolumeTypes string[] 示例值：[ "ESSD_FlexPL", "ESSD_PL0"]

支持的云盘类型列表。

NextToken string 示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******

本次调用返回的查询凭证值，返回为空表示没有下一页。

请求示例

GET /?Action=DescribeInstanceTypes&Version=2020-04-01&InstanceTypeIds.1=ecs.g3i.large HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2021110417394001022514606307D7****",​
    "Action": "DescribeInstanceTypes",​
    "Version": "2020-04-01",​
    "Service": "ecs",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "InstanceTypes": [​
      {​
        "InstanceTypeFamily": "ecs.g3i",​
        "Gpu": null,​
        "Rdma": null,​
        "BaselineCredit": 0,​
        "InitialCredit": 0,​
        "InstanceTypeId": "ecs.g3i.large",​
        "IsSupportEsi": "true",​
        "IsSupportAffinityGroup": false,​
        "AffinityGroupSizes": [],​
        "IsSupportJumboFrame": false,​
        "Processor": {​
          "Cpus": 2,​
          "Model": "Intel Xeon(Ice Lake) Platinum 8336C",​
          "BaseFrequency": 2.3,​
          "TurboFrequency": 3​
        },​
        "Memory": {​
          "Size": 8192,​
          "EncryptedSize": 0​
        },​
        "Network": {​
          "MaximumNetworkInterfaces": 3,​
          "MaximumPrivateIpv4AddressesPerNetworkInterface": 6,​
          "MaximumQueuesPerNetworkInterface": 2,​
          "BaselineBandwidthMbps": 2000,​
          "MaximumBandwidthMbps": 2000,​
          "MaximumThroughputKpps": 500​
        },​
        "LocalVolumes": [],​
        "Volume": {​
          "SupportedVolumeTypes": [​
            "ESSD_FlexPL",​
            "ESSD_PL0"​
          ],​
          "MaximumCount": 16​
        }​
      }​
    ],​
    "NextToken": "bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******"​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidArgument	The specified argument is invalid.	指定的参数不合法。
404	InvalidActionOrVersion	Could not find operation %s for version %s.	请求接口不存在。
404	InvalidImage.NotFound	The specified image does not exist.	指定的镜像不存在。
429	FlowLimitExceeded	You've reach the limit on request rate of resources.	您已超过资源请求限速。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.09.09 15:54:45

这个页面对您有帮助吗？

有用

无用