DescribeInstanceTypes - API参考| 阿里云

描述

根据 DescribeInstanceTypes 查询的实例规格列表与创建实例时按量付费实例列表一致。更多详情，请参阅按量付费和使用限制。

更多详情，请参阅实例规格族。

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

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	否	DescribeInstanceTypes	接口名称。取值：DescribeInstanceTypes
InstanceTypeFamily	String	否	ecs.t1	实例规格所属的规格族。更多详情，请参阅实例规格族。
OwnerAccount	String	否	ECSforCloud@Alibaba.com	RAM用户的账号登录名称。

返回参数


名称	类型	示例值	描述
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/>
      <MemorySize>0.5</MemorySize>
      <GPUAmount>0</GPUAmount>
      <LocalStorageCategory/>
    </InstanceType>
    <InstanceType>
      <CpuCoreCount>1</CpuCoreCount>
      <InstanceTypeFamily>ecs.t1</InstanceTypeFamily>
      <EniQuantity>1</EniQuantity>
      <InstanceTypeId>ecs.t1.small</InstanceTypeId>
      <InstanceFamilyLevel>EntryLevel</InstanceFamilyLevel>
      <GPUSpec/>
      <MemorySize>1</MemorySize>
      <GPUAmount>0</GPUAmount>
      <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"
}

错误码

查看本产品错误码