DescribeInstanceTypes_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

分页查询：您可以设置 MaxResults 参数以限制返回值中实例规格的条目数，如果只返回了部分被查询到的实例规格的条目数，则会同步返回 NextToken 参数值。再次调用该接口，设置上次调用该接口返回的 NextToken 参数值以及 MaxResults 参数，以实现分页查询实例规格信息。
若您调用该 API 时未传入 NextToken 参数进行分页获取，默认只返回第一页（不超过 100 条）数据，若需要更多数据，请您传入 NextToken 进行分页获取或传入过滤条件来限制返回的数据范围。

说明 MaxResults（每页最大条目数）参数的最大值为 100，对于在 2022 年调用过本 API 的用户，MaxResults 参数的最大值仍为 1600，在 2023 年 11 月 15 日及之后，我们将对所有用户的 MaxResults 参数的最大值缩小到 100，不再支持 1600。

DescribeInstanceTypes 仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格，请使用 DescribeAvailableResource 。
如果您需要使用非售卖可见的实例规格或特别的规格需求，请提交工单。

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作
暂无数据

请求参数

字段名称	字段详情
InstanceTypeFamilystring	实例规格所属的实例规格族。取值请参见 DescribeInstanceTypeFamilies 。展开详情示例值:ecs.g6参考取值来源: DescribeInstanceTypeFamilies
InstanceTypesarray<string>	指定的实例规格数组。数组长度：1~10。当该参数不传值时，默认查询所有实例规格的信息。示例值:ecs.g6.large子级条数 <= 10
MinimumCpuCoreCountinteger<int32>	查询实例规格时，期望最小 vCPU 内核的数目。取值范围：正整数。展开详情示例值:2
MaximumCpuCoreCountinteger<int32>	查询实例规格时，期望最大 vCPU 内核的数目。取值范围：正整数。展开详情示例值:10
MinimumMemorySizenumber<float>	查询实例规格时，期望最小内存。单位：GiB。展开详情示例值:20
MaximumMemorySizenumber<float>	查询实例规格时，期望最大内存。单位：GiB。展开详情示例值:60
MinimumGPUAmountinteger<int32>	查询实例规格时，期望最小 GPU 数目。取值范围：正整数。展开详情示例值:3
MaximumGPUAmountinteger<int32>	查询实例规格时，期望最大 GPU 数目。取值范围：正整数。展开详情示例值:10
GPUSpecstring	GPU 类型。展开详情示例值:NVIDIA V100
InstanceCategorystring	实例规格分类。取值范围：展开详情示例值:Big data枚举值:General-purposeCompute-optimizedMemory-optimizedBig dataLocal SSDsHigh Clock SpeedEnhancedSharedCompute-optimized with GPUVisual Compute-optimizedHeterogeneous ServiceCompute-optimized with FPGACompute-optimized with NPUECS Bare MetalSuper Computing ClusterHigh Performance Compute
CpuArchitecturestring	CPU 架构。取值范围：展开详情示例值:X86枚举值:X86ARM
MinimumCpuSpeedFrequencynumber<float>	查询实例规格时，期望最小主频。展开详情示例值:2.5
MaximumCpuSpeedFrequencynumber<float>	查询实例规格时，期望最大主频。展开详情示例值:3.2
MinimumCpuTurboFrequencynumber<float>	查询实例规格时，期望最小睿频。展开详情示例值:3.2
MaximumCpuTurboFrequencynumber<float>	查询实例规格时，期望最大睿频。展开详情示例值:4.1
PhysicalProcessorModelstring	处理器型号。展开详情示例值:Intel Xeon(Ice Lake) Platinum 8369B
InstanceFamilyLevelstring	实例规格族级别。取值范围：展开详情示例值:EntryLevel枚举值:EntryLevelEnterpriseLevelCreditEntryLevel
MinimumInstancePpsRxinteger<int64>	查询实例规格时，期望最小内网入方向网络收发包能力。单位：pps。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:15
MinimumInstancePpsTxinteger<int64>	查询实例规格时，期望最小内网出方向网络收发包能力。单位：pps。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:15
MinimumInstanceBandwidthRxinteger<int32>	查询实例规格时，期望最小内网入方向带宽限制，单位：kbit/s。展开详情示例值:12288
MinimumInstanceBandwidthTxinteger<int32>	查询实例规格时，期望最小内网出方向带宽限制，单位：kbit/s。展开详情示例值:12288
MinimumPrimaryEniQueueNumberinteger<int32>	查询实例规格时，期望最小主网卡默认队列数。展开详情示例值:8
MinimumSecondaryEniQueueNumberinteger<int32>	查询实例规格时，期望最小辅助弹性网卡默认队列数。展开详情示例值:4
MinimumEniQuantityinteger<int32>	查询实例规格时，期望最小支持挂载的弹性网卡上限。展开详情示例值:4
MinimumQueuePairNumberinteger<int32>	查询实例规格时，期望最小单块弹性 RDMA 网卡（ERI）的 QP（QueuePair）队列数上限。展开详情示例值:8
MinimumEriQuantityinteger<int32>	查询实例规格时，期望最小弹性 RDMA 网卡（ERI）数量。展开详情示例值:0
MinimumEniPrivateIpAddressQuantityinteger<int32>	查询实例规格时，期望最小单块弹性网卡的 IPv4 地址上限。展开详情示例值:2
MinimumEniIpv6AddressQuantityinteger<int32>	查询实例规格时，期望最小单块弹性网卡的 IPv6 地址上限。展开详情示例值:2
MinimumLocalStorageAmountinteger<int32>	查询实例规格时，期望最小实例挂载的本地盘的数量。展开详情示例值:4
MinimumLocalStorageCapacityinteger<int64>	实例挂载的本地盘的单盘容量。单位：GiB 注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:40
MinimumDiskQuantityinteger<int32>	查询实例规格时，期望最小支持挂载的云盘数量上限。展开详情示例值:4
LocalStorageCategorystring	本地盘类型。更多信息，请参见本地盘。取值范围：展开详情示例值:local_ssd_pro枚举值:local_hdd_prolocal_ssd_pro
NvmeSupportstring	实例规格所挂载的云盘是否支持 NVMe。取值范围：展开详情示例值:required枚举值:requiredunsupported
MinimumBaselineCreditinteger<int32>	查询实例规格时，期望最小突发性能实例 t5、t6 的基准 vCPU 计算性能（所有 vCPU 之和）。展开详情示例值:12
MinimumInitialCreditinteger<int32>	查询实例规格时，期望最小突发性能实例 t5、t6 的初始 vCPU 积分值。展开详情示例值:12
InstanceTypeFamiliesarray<string>	指定查询的实例规格族数组。数组长度：1~10。子级条数 <= 10
GpuSpecsarray<string>	指定查询的 GPU 类型数组。数组长度：1~10。子级条数 <= 10
InstanceCategoriesarray<string>	指定查询的实例规格分类数组。数组长度：1~10。子级条数 <= 10
CpuArchitecturesarray<string>	指定查询的 CPU 架构数组。数组长度：1~2。子级条数 <= 10
PhysicalProcessorModelsarray<string>	指定查询的处理器型号数组。数组长度：1~10。子级条数 <= 10
LocalStorageCategoriesarray<string>	指定的本地盘类型数组。数组长度：1~2。子级条数 <= 10
MaxResultsinteger<int64>	分页查询时每页的最大条目数。最大值：1600展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:10取值 <= 1600
NextTokenstring	查询凭证（Token）。取值为上一次调用该接口返回的 NextToken 参数值，初次调用接口时无需设置该参数。示例值:e71d8a535bd9cc11字符长度 <= 50

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:00827261-20B7-4562-83F2-4DF39876A45A
InstanceTypesobject
NextTokenstring	本次调用返回的查询凭证（Token）。示例值:e71d8a535bd9cc11

DescribeInstanceTypes_云服务器 ECS_API文档