调用DescribeInstanceTypes查询云服务器ECS提供的所有实例规格的信息，也可以查询指定实例规格的信息。
接口说明
DescribeInstanceTypes仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格，请使用DescribeAvailableResource。
如果您需要使用非售卖可见的实例规格或特别的规格需求，请提交工单联系阿里云。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeInstanceTypes |
系统规定参数。取值：DescribeInstanceTypes |
| InstanceTypeFamily | String | 否 | ecs.g6 |
实例规格所属的规格族。取值请参见DescribeInstanceTypeFamilies。 更多详情，请参见实例规格族。 |
| InstanceTypes.N | RepeatList | 否 | ecs.g6.large |
指定的实例规格。N的取值范围：1~10。当该参数不传值时，默认查询所有实例规格的信息。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| InstanceTypes | Array of InstanceType |
实例规格集合。 |
|
| InstanceType | |||
| BaselineCredit | Integer | 4 |
突发性能实例t5、t6的基准vCPU计算性能（所有vCPU之和）。 |
| CpuCoreCount | Integer | 2 |
vCPU内核数目。 |
| DiskQuantity | Integer | 17 |
支持挂载的云盘数量上限。 |
| EniIpv6AddressQuantity | Integer | 1 |
单块弹性网卡的IPv6地址上限。 |
| EniPrivateIpAddressQuantity | Integer | 6 |
单块弹性网卡的私有IP地址上限。 |
| EniQuantity | Integer | 2 |
支持挂载的弹性网卡上限。 |
| EniTotalQuantity | Integer | 0 |
说明 该参数正在邀测中，暂未开放使用。
|
| EniTrunkSupported | Boolean | false |
说明 该参数正在邀测中，暂未开放使用。
|
| GPUAmount | Integer | 0 |
GPU数量。 |
| GPUSpec | String | NVIDIA V100 |
GPU类型。 |
| InitialCredit | Integer | 120 |
突发性能实例t5、t6的初始vCPU积分值。 |
| InstanceBandwidthRx | Integer | 1024000 |
内网入方向带宽限制。单位：kbit/s |
| InstanceBandwidthTx | Integer | 1024000 |
内网出方向带宽限制。单位：kbit/s |
| InstanceFamilyLevel | String | EnterpriseLevel |
实例规格族级别。可能值：
|
| InstancePpsRx | Long | 300000 |
内网入方向网络收发包能力。单位：Pps |
| InstancePpsTx | Long | 300000 |
内网出方向网络收发包能力。单位：Pps |
| InstanceTypeFamily | String | ecs.g6 |
实例规格族。 |
| InstanceTypeId | String | ecs.g6.large |
实例规格ID。 |
| LocalStorageAmount | Integer | 1 |
实例挂载的本地盘的数量。 |
| LocalStorageCapacity | Long | 5000 |
实例挂载的本地盘的单盘容量。单位：GiB |
| LocalStorageCategory | String | local_ssd_pro |
本地盘类型，详情请参见本地盘。可能值：
|
| MaximumQueueNumberPerEni | Integer | 2 |
单块弹性网卡最大队列数。 |
| MemorySize | Float | 8.0 |
内存大小。单位：GiB |
| PrimaryEniQueueNumber | Integer | 2 |
主网卡默认队列数。 |
| SecondaryEniQueueNumber | Integer | 2 |
辅助弹性网卡默认队列数。 |
| TotalEniQueueQuantity | Integer | 4 |
实例规格允许修改的弹性网卡队列数总配额。 |
| RequestId | String | 00827261-20B7-4562-83F2-4DF39876A45A |
请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.g6
&<公共请求参数>正常返回示例
XML格式
<DescribeInstanceTypesResponse>
<RequestId>00827261-20B7-4562-83F2-4DF39876A45A</RequestId>
<InstanceTypes>
<InstanceType>
<MemorySize>8</MemorySize>
<InstancePpsTx>300000</InstancePpsTx>
<MaximumQueueNumberPerEni>2</MaximumQueueNumberPerEni>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<PrimaryEniQueueNumber>2</PrimaryEniQueueNumber>
<CpuCoreCount>2</CpuCoreCount>
<TotalEniQueueQuantity>4</TotalEniQueueQuantity>
<EniTotalQuantity>2</EniTotalQuantity>
<EniTrunkSupported>false</EniTrunkSupported>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>300000</InstancePpsRx>
<EniQuantity>2</EniQuantity>
<InstanceBandwidthRx>1024000</InstanceBandwidthRx>
<GPUAmount>0</GPUAmount>
<InstanceBandwidthTx>1024000</InstanceBandwidthTx>
<SecondaryEniQueueNumber>2</SecondaryEniQueueNumber>
<DiskQuantity>17</DiskQuantity>
<LocalStorageCategory></LocalStorageCategory>
<GPUSpec></GPUSpec>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeId>ecs.g6.large</InstanceTypeId>
<EniPrivateIpAddressQuantity>6</EniPrivateIpAddressQuantity>
</InstanceType>
</InstanceTypes>
</DescribeInstanceTypesResponse>JSON格式
{
"RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
"InstanceTypes": {
"InstanceType": [
{
"MemorySize": 8,
"InstancePpsTx": 300000,
"MaximumQueueNumberPerEni": 2,
"EniIpv6AddressQuantity": 1,
"PrimaryEniQueueNumber": 2,
"CpuCoreCount": 2,
"TotalEniQueueQuantity": 4,
"EniTotalQuantity": 2,
"EniTrunkSupported": false,
"InstanceTypeFamily": "ecs.g6",
"InstancePpsRx": 300000,
"EniQuantity": 2,
"InstanceBandwidthRx": 1024000,
"GPUAmount": 0,
"InstanceBandwidthTx": 1024000,
"SecondaryEniQueueNumber": 2,
"DiskQuantity": 17,
"LocalStorageCategory": "",
"GPUSpec": "",
"InstanceFamilyLevel": "EnterpriseLevel",
"InstanceTypeId": "ecs.g6.large",
"EniPrivateIpAddressQuantity": 6
}
]
}
}错误码
访问错误中心查看更多错误码。
