You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeInstanceTypes

最近更新时间：2024.01.31 15:47:49

首次发布时间：2021.12.29 11:18:50

我的收藏

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

说明

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

调试

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

请求参数

名称类型是否必选示例值描述
ActionString是DescribeInstanceTypes要执行的操作，取值：DescribeInstanceTypes。
VersionString是2020-04-01API的版本，取值：2020-04-01。
NextTokenString否-分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

MaxResults

Integer

否

10

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

  • 最小值：1
  • 最大值：1000
  • 默认值：10

InstanceTypeIds.N

String

否

InstanceTypeIds.1=ecs.g3i.large&InstanceTypeIds.2=ecs.g1ve.8xlarge

指定查询的实例规格。

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

  • 多个InstanceTypeId 之间用&分隔。

说明

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

返回数据

名称类型示例值
描述
InstanceTypesArray of Struct-符合条件的实例规格信息，具体请参见下表“ InstanceTypes 结构 ”。
NextTokenStringbHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******本次调用返回的查询凭证值，返回为空表示没有下一页。

InstanceTypes 结构

名称类型示例值描述
InstanceTypeFamilyStringecs.g3i实例规格族。
GpuStruct-GPU规格信息，具体请参见下表“ Gpu 结构 ”。
RdmaStruct-RDMA规格信息，具体请参见下表“ Rdma 结构 ”。
BaselineCreditInteger20突发性能实例可以持续稳定地提供的CPU基准性能，由实例规格决定。
InitialCreditInteger60创建突发性能实例时一次性获得的CPU积分，固定为每vCPU 30个积分。
InstanceTypeIdStringecs.g3i.large实例规格ID。
ProcessorStruct-
实例规格的CPU信息，具体请参见下表“ Processor 结构 ”。
MemoryStruct-实例规格的内存信息，具体参见下表“ Memory 结构 ”。
NetworkStruct-实例规格的网络信息，具体见下表“ Network 结构 ”。
LocalVolumesArray of Struct-实例规格对应的本地盘配置信息，具体参见下表“ LocalVolumes 结构 ”。
VolumeStruct-实例规格的云盘信息，具体见下表“ Volume 结构 ”。

Gpu结构

名称类型示例值描述
GpuDevicesArray of Struct-
GPU设备信息列表，具体请参见下表“ GpuDevices 结构 ”。
GpuDevices 结构
名称类型示例值描述
CountInteger4GPU卡的数量。
ProductNameStringNVIDIA A100GPU型号。
MemoryStruct-
显存信息，具体请参见表“ Memory 结构 ”。

Rdma 结构

名称类型示例值描述
RdmaNetworkInterfacesInteger2
RDMA网卡数量。

Processor 结构

名称类型示例值描述
CpusInteger8
CPU数量。
ModelStringIntel Xeon(Ice Lake) Platinum 8336CCPU型号。
BaseFrequencyFloat322.3CPU主频，单位：GHz。
TurboFrequencyFloat323.0CPU睿频，单位：GHz。

Memory 结构

名称类型示例值描述
SizeInteger4096
内存大小，单位：MiB。

EncryptedSize

Integer

8192

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

  • 当InstanceTypeFamily=ecs.ebmg2t，即安全增强型弹性裸金属实例时分配有加密内存，且最高可设置为256GiB，其余规格默认为0。
  • 安全增强型弹性裸金属实例正在邀测中，如需试用，请提交工单或联系客户经理申请。

Network 结构

名称类型示例值描述

MaximumNetworkInterfaces

Integer

8

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

MaximumPrivateIpv4AddressesPerNetworkInterfaceInteger20单块弹性网卡的IPv4地址数量上限，具体请参见实例规格介绍。
MaximumQueuesPerNetworkInterfaceInteger16单块弹性网卡最大队列数，包括主网卡及辅助网卡支持的队列数，具体请参见实例规格介绍。
MaximumThroughputKppsInteger150网络收发包能力（出+入），单位：Kpps。
BaselineBandwidthMbpsInteger2000网络基准带宽能力（出/入），单位：Mbps。

MaximumBandwidthMbps

Integer

2000

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

说明

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

LocalVolumes 结构

名称类型示例值
描述

VolumeType

String

LOCAL_SSD

本地盘类型，取值：

  • LOCAL_SSD：SSD本地盘
  • LOCAL_HDD：HDD本地盘
SizeInteger200实例挂载的本地盘的单盘容量，单位GiB。
CountInteger4实例挂载的本地盘的数量。

Volume 结构

名称类型示例值
描述
SupportedVolumeTypesList[ "ESSD_FlexPL", "ESSD_PL0"]支持的云盘类型列表。

MaximumCount

Integer

16

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

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

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

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

请求示例

GET /?Action=DescribeInstanceTypes&Version=2020-04-01&InstanceTypeIds.1=ecs.g3i.large HTTP/1.1
Host: open.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",
                        "Processor": {
                                "Cpus": 2,
                               "Model": "Intel Xeon(Ice Lake) Platinum 8336C",
                                "BaseFrequency": 2.3,
                                "TurboFrequency": 3.0
                        },
                        "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******"
        }
}

错误码

HttpCode错误码错误信息描述
400InvalidArgumentThe specified argument is invalid.指定的参数不合法。

429

FlowLimitExceeded

You've reach the limit on request rate of resources.

您已超过资源请求限速。

500InternalErrorAn internal error has occurred.内部错误，请重试。如果多次尝试失败，请提交工单。