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

接口说明

DescribeInstanceTypes仅查询所有ECS实例规格的详情。如果您需要查询具体地域下可购买的实例规格,请使用DescribeAvailableResource

如果您需要使用更多实例规格资源,可以提交工单联系我们。

调试

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

请求参数

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

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

InstanceTypeFamily String ecs.t1

实例规格所属的规格族。更多详情,请参见实例规格族

返回数据

名称 类型 示例值 描述
InstanceTypes

由实例规格项InstanceTypeItemType组成的集合。

BaselineCredit Integer 4

突发性能实例基准vCPU计算性能(多核和)。

CpuCoreCount Integer 8

vCPU内核数目。

EniPrivateIpAddressQuantity Integer 2

实例绑定的弹性网卡中分配的私有IP地址数量。

EniQuantity Integer 2

实例规格支持网卡数量。

GPUAmount Integer 2

实例规格附带GPU数量。

GPUSpec String NVIDIA V100

实例规格附带GPU类型。

InitialCredit Integer 120

突发性能实例的初始积分值。

InstanceBandwidthRx Integer 2000

内网入方向带宽限制,单位为kbps。

InstanceBandwidthTx Integer 2000

内网出方向带宽限制,单位为kbps。

InstanceFamilyLevel String EnterpriseLevel

实例规格级别。可能值:

  • EntryLevel:入门级。
  • EnterpriseLevel:企业级。
  • CreditEntryLevel:积分入门级,特指突发性能实例
InstancePpsRx Long 300

内网入方向PPS限制。

InstancePpsTx Long 300

内网出方向PPS限制。

InstanceTypeFamily String ecs.g5

实例规格族。

InstanceTypeId String ecs.g5.large

实例规格ID。

LocalStorageAmount Integer 1

实例挂载的本地存储的数量。

LocalStorageCapacity Long 5000

实例挂载的本地存储的单盘容量。

LocalStorageCategory String ephemeral_ssd

实例挂载的本地存储的类型。

MemorySize Float 1024

内存大小,单位GiB。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.t1
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstanceTypesResponse>
	  <InstanceTypes>
		    <InstanceType>
			      <CpuCoreCount>1</CpuCoreCount>
			      <InstanceTypeFamily>ecs.t1</InstanceTypeFamily>
			      <EniQuantity>1</EniQuantity>
			      <InstanceTypeId>ecs.t1.xsmall</InstanceTypeId>
			      <InstanceFamilyLevel>EntryLevel</InstanceFamilyLevel>
			      <GPUSpec></GPUSpec>
			      <MemorySize>0.5</MemorySize>
			      <GPUAmount>0</GPUAmount>
			      <LocalStorageCategory></LocalStorageCategory>
		    </InstanceType>
		    <InstanceType>
			      <CpuCoreCount>1</CpuCoreCount>
			      <InstanceTypeFamily>ecs.t1</InstanceTypeFamily>
			      <EniQuantity>1</EniQuantity>
			      <InstanceTypeId>ecs.t1.small</InstanceTypeId>
			      <InstanceFamilyLevel>EntryLevel</InstanceFamilyLevel>
			      <GPUSpec></GPUSpec>
			      <MemorySize>1</MemorySize>
			      <GPUAmount>0</GPUAmount>
			      <LocalStorageCategory></LocalStorageCategory>
		    </InstanceType>
	  </InstanceTypes>
	  <RequestId>01D5A075-FB83-4DDC-9F00-24A17AB386F6</RequestId>
</DescribeInstanceTypesResponse>

JSON 格式

{
	"InstanceTypes":{
		"InstanceType":[
			{
				"CpuCoreCount":1,
				"InstanceTypeFamily":"ecs.t1",
				"EniQuantity":1,
				"InstanceTypeId":"ecs.t1.xsmall",
				"GPUSpec":"",
				"InstanceFamilyLevel":"EntryLevel",
				"MemorySize":0.5,
				"GPUAmount":0,
				"LocalStorageCategory":""
			},
			{
				"CpuCoreCount":1,
				"InstanceTypeFamily":"ecs.t1",
				"EniQuantity":1,
				"InstanceTypeId":"ecs.t1.small",
				"GPUSpec":"",
				"InstanceFamilyLevel":"EntryLevel",
				"MemorySize":1,
				"GPUAmount":0,
				"LocalStorageCategory":""
			}
		]
	},
	"RequestId":"01D5A075-FB83-4DDC-9F00-24A17AB386F6"
}

错误码

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