接口说明
-
分页查询：您可以设置 MaxResults 参数以限制返回值中实例规格的条目数，如果只返回了部分被查询到的实例规格的条目数，则会同步返回 NextToken 参数值。再次调用该接口，设置上次调用该接口返回的 NextToken 参数值以及 MaxResults 参数，以实现分页查询实例规格信息。
-
若您调用该 API 时未传入 NextToken 参数进行分页获取，默认只返回第一页（不超过 100 条）数据，若需要更多数据，请您传入 NextToken 进行分页获取或传入过滤条件来限制返回的数据范围。
-
DescribeInstanceTypes 仅查询实例规格的配置和性能信息。如果您需要查询具体地域下可购买的实例规格，请使用 DescribeAvailableResource 。
-
如果您需要使用非售卖可见的实例规格或特别的规格需求，请提交工单。
流控信息
授权信息
请求参数
| 字段名称 | 字段详情 |
|---|---|
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 | |
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 |