调用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

实例规格族级别。可能值：

  • EntryLevel：入门级。
  • EnterpriseLevel：企业级。
  • CreditEntryLevel：积分入门级。详情请参见突发性能实例。
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

本地盘类型，详情请参见本地盘。可能值：

  • local_hdd_pro：实例规格族d1ne和d1搭载的SATA HDD本地盘。
  • local_ssd_pro：实例规格族i2、i2g、i1、ga1和gn5等搭载的NVMe SSD本地盘。
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
			}
		]
	}
}

错误码

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