调用DescribeInstanceTypes查询云服务器ECS提供的实例规格资源。

接口说明

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

如果您需要使用更多实例规格资源,请提交工单联系阿里云。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeInstanceTypes

接口名称。对于您自行拼凑HTTP/HTTPS URL发起的API请求,Action为必选参数。取值:DescribeInstanceTypes

InstanceTypeFamily String ecs.g6

实例规格所属的规格族。取值请参见DescribeInstanceTypeFamilies

更多详情,请参见实例规格族

返回数据

名称 类型 示例值 描述
InstanceTypes Array

实例规格族集合。

InstanceType
BaselineCredit Integer 4

突发性能实例t5、t6的基准vCPU计算性能(所有vCPU之和)。

CpuCoreCount Integer 8

vCPU内核数目。

EniIpv6AddressQuantity Integer 1

单块弹性网卡的IPv6地址上限。

EniPrivateIpAddressQuantity Integer 6

单块弹性网卡的私有IP地址上限。

EniQuantity Integer 2

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

GPUAmount Integer 2

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.g5

实例规格族。

InstanceTypeId String ecs.g5.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本地盘。
MemorySize Float 8.0

内存大小,单位GiB。

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>384</MemorySize>
                  <InstancePpsTx>6000000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>104</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>6000000</InstancePpsRx>
                  <EniQuantity>15</EniQuantity>
                  <InstanceBandwidthRx>25600000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>25600000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.26xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>192</MemorySize>
                  <InstancePpsTx>3000000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>52</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>3000000</InstancePpsRx>
                  <EniQuantity>7</EniQuantity>
                  <InstanceBandwidthRx>12800000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>12800000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.13xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>256</MemorySize>
                  <InstancePpsTx>4000000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>64</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>4000000</InstancePpsRx>
                  <EniQuantity>8</EniQuantity>
                  <InstanceBandwidthRx>20480000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>20480000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.16xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>32</MemorySize>
                  <InstancePpsTx>800000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>8</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>800000</InstancePpsRx>
                  <EniQuantity>4</EniQuantity>
                  <InstanceBandwidthRx>2560000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>2560000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.2xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>8</MemorySize>
                  <InstancePpsTx>300000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>2</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>300000</InstancePpsRx>
                  <EniQuantity>2</EniQuantity>
                  <InstanceBandwidthRx>1024000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>1024000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.large</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>6</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>16</MemorySize>
                  <InstancePpsTx>500000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>4</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>500000</InstancePpsRx>
                  <EniQuantity>3</EniQuantity>
                  <InstanceBandwidthRx>1536000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>1536000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>48</MemorySize>
                  <InstancePpsTx>900000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>12</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>900000</InstancePpsRx>
                  <EniQuantity>6</EniQuantity>
                  <InstanceBandwidthRx>4096000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>4096000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.3xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>64</MemorySize>
                  <InstancePpsTx>1000000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>16</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>1000000</InstancePpsRx>
                  <EniQuantity>8</EniQuantity>
                  <InstanceBandwidthRx>5120000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>5120000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.4xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>96</MemorySize>
                  <InstancePpsTx>1500000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>24</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>1500000</InstancePpsRx>
                  <EniQuantity>8</EniQuantity>
                  <InstanceBandwidthRx>7680000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>7680000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.6xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
            <InstanceType>
                  <MemorySize>128</MemorySize>
                  <InstancePpsTx>2000000</InstancePpsTx>
                  <EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
                  <CpuCoreCount>32</CpuCoreCount>
                  <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
                  <InstancePpsRx>2000000</InstancePpsRx>
                  <EniQuantity>8</EniQuantity>
                  <InstanceBandwidthRx>10240000</InstanceBandwidthRx>
                  <GPUAmount>0</GPUAmount>
                  <InstanceBandwidthTx>10240000</InstanceBandwidthTx>
                  <LocalStorageCategory></LocalStorageCategory>
                  <GPUSpec></GPUSpec>
                  <InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
                  <InstanceTypeId>ecs.g6.8xlarge</InstanceTypeId>
                  <EniPrivateIpAddressQuantity>20</EniPrivateIpAddressQuantity>
            </InstanceType>
      </InstanceTypes>
</DescribeInstanceTypesResponse>

JSON 格式

{
	"RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
	"InstanceTypes": {
		"InstanceType": [
			{
				"MemorySize": 384,
				"InstancePpsTx": 6000000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 104,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 6000000,
				"EniQuantity": 15,
				"InstanceBandwidthRx": 25600000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 25600000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.26xlarge",
				"EniPrivateIpAddressQuantity": 20
			},
			{
				"MemorySize": 192,
				"InstancePpsTx": 3000000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 52,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 3000000,
				"EniQuantity": 7,
				"InstanceBandwidthRx": 12800000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 12800000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.13xlarge",
				"EniPrivateIpAddressQuantity": 20
			},
			{
				"MemorySize": 256,
				"InstancePpsTx": 4000000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 64,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 4000000,
				"EniQuantity": 8,
				"InstanceBandwidthRx": 20480000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 20480000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.16xlarge",
				"EniPrivateIpAddressQuantity": 20
			},
			{
				"MemorySize": 32,
				"InstancePpsTx": 800000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 8,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 800000,
				"EniQuantity": 4,
				"InstanceBandwidthRx": 2560000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 2560000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.2xlarge",
				"EniPrivateIpAddressQuantity": 10
			},
			{
				"MemorySize": 8,
				"InstancePpsTx": 300000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 2,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 300000,
				"EniQuantity": 2,
				"InstanceBandwidthRx": 1024000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 1024000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.large",
				"EniPrivateIpAddressQuantity": 6
			},
			{
				"MemorySize": 16,
				"InstancePpsTx": 500000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 4,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 500000,
				"EniQuantity": 3,
				"InstanceBandwidthRx": 1536000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 1536000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.xlarge",
				"EniPrivateIpAddressQuantity": 10
			},
			{
				"MemorySize": 48,
				"InstancePpsTx": 900000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 12,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 900000,
				"EniQuantity": 6,
				"InstanceBandwidthRx": 4096000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 4096000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.3xlarge",
				"EniPrivateIpAddressQuantity": 10
			},
			{
				"MemorySize": 64,
				"InstancePpsTx": 1000000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 16,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 1000000,
				"EniQuantity": 8,
				"InstanceBandwidthRx": 5120000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 5120000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.4xlarge",
				"EniPrivateIpAddressQuantity": 20
			},
			{
				"MemorySize": 96,
				"InstancePpsTx": 1500000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 24,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 1500000,
				"EniQuantity": 8,
				"InstanceBandwidthRx": 7680000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 7680000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.6xlarge",
				"EniPrivateIpAddressQuantity": 20
			},
			{
				"MemorySize": 128,
				"InstancePpsTx": 2000000,
				"EniIpv6AddressQuantity": 1,
				"CpuCoreCount": 32,
				"InstanceTypeFamily": "ecs.g6",
				"InstancePpsRx": 2000000,
				"EniQuantity": 8,
				"InstanceBandwidthRx": 10240000,
				"GPUAmount": 0,
				"InstanceBandwidthTx": 10240000,
				"LocalStorageCategory": "",
				"GPUSpec": "",
				"InstanceFamilyLevel": "EnterpriseLevel",
				"InstanceTypeId": "ecs.g6.8xlarge",
				"EniPrivateIpAddressQuantity": 20
			}
		]
	}
}

错误码

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