调用DescribePatternTypes接口,并可以指定交换机的ID、实例的vCPU核数、内存大小、规格族级别以及可接受的最高价格等参数,筛选出符合要求的实例规格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribePatternTypes | 系统规定参数。取值:DescribePatternTypes。 |
RegionId | String | 是 | cn-hangzhou | 所属地域ID。 |
VSwitchId.N | String | 否 | vsw-bp14zolna43z266bq**** | 交换机的ID。 |
ZoneId.N | String | 否 | cn-hangzhou-g | 可用区ID。 |
SpotStrategy | String | 否 | NoSpot | 后付费实例的抢占策略。取值范围:
默认值:NoSpot。 |
Cores | Integer | 否 | 2 | 实例规格的vCPU内核数目。 |
Memory | Float | 否 | 4 | 实例规格的内存大小,单位为GiB。 |
MaxPrice | Float | 否 | 2 | 按量付费实例或者抢占式实例可接受的每小时最高价格。 |
InstanceFamilyLevel | String | 否 | EnterpriseLevel | 实例规格族级别。取值范围: |
ExcludedInstanceType.N | String | 否 | ecs.c6.xlarge | 需要排除的实例规格。通过使用通配符(*)可以排除单个规格或者整个规格族。例如:
说明 如果需要排除多个实例规格,请使用分隔符(/)隔开单个实例规格。例如 ecs.n1.small/ecs.n1.*/*7* 。 |
Architecture.N | String | 否 | X86 | 实例规格所属的架构类型。取值范围:
默认值:包含所有架构类型。 |
BurstablePerformance | String | 否 | Include | 是否为性能突发实例规格。取值范围:
默认值:Include。 |
CoresList.N | Integer | 否 | 2 | 实例规格的vCPU内核数目,可以指定多个。 |
MemoryList.N | Float | 否 | 4 | 实例规格的内存大小,单位为GiB,可以指定多个。 |
ChannelId | Long | 否 | 79425074 | 渠道ID。 说明 该参数不对外开放(仅为内部保留参数)。 |
InstanceTypeFamilies.N | String | 否 | ecs.g6 | 指定查询的实例规格族。N 表示可以设置多个实例规格族,N 的取值范围:1~10。 |
MinimumCpuCoreCount | Integer | 否 | 2 | 实例规格的最小vCPU内核数目。 |
MaximumCpuCoreCount | Integer | 否 | 4 | 实例规格的最大vCPU内核数目。 |
GpuSpecs.N | String | 否 | NVIDIA V100 | GPU 类型。 |
InstanceCategories.N | String | 否 | Compute-optimized with GPU | 实例规格分类。取值范围:
|
CpuArchitectures.N | String | 否 | X86 | 实例规格的CPU架构。取值范围: 说明 N表示可以设置多个CPU架构,N的取值范围:1~2。
|
PhysicalProcessorModels.N | String | 否 | Intel Xeon(Ice Lake) Platinum 8369B | 实例的处理器型号。N表示可以设置多个处理器型号,N的取值范围:1~10。 |
MinimumEniQuantity | Integer | 否 | 2 | 实例最小支持挂载的弹性网卡上限。 |
MinimumEniPrivateIpAddressQuantity | Integer | 否 | 2 | 实例最小单块弹性网卡的IPv4地址上限。 |
MinimumEniIpv6AddressQuantity | Integer | 否 | 1 | 实例最小单块弹性网卡的IPv6地址上限。 |
MinimumInitialCredit | Integer | 否 | 12 | 实例最小突发性能实例t5、t6的初始vCPU积分值。 |
MinimumBaselineCredit | Integer | 否 | 12 | 实例最小突发性能实例t5、t6的基准vCPU计算性能(所有vCPU之和)。 |
MinimumMemorySize | Float | 否 | 4 | 实例最小内存。单位:GiB。 |
MaximumMemorySize | Float | 否 | 4 | 实例最大内存。单位:GiB。 |
MinimumGpuAmount | Integer | 否 | 2 | 实例最小 GPU 数目。取值范围:正整数。 |
MaximumGpuAmount | Integer | 否 | 2 | 实例最大 GPU 数目。取值范围:正整数。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 请求ID。 |
PatternTypes | Array of PatternType | 符合条件的实例规格。 |
|
InstanceType | String | ecs.c7.xlarge | 实例规格名称。 |
InstanceFamilyLevel | String | EnterpriseLevel | 实例规格族级别。可能值: |
InstanceTypeFamily | String | ecs.c7 | 实例规格族。 |
Cores | Integer | 4 | 实例规格的vCPU核数。 |
Memory | Float | 8 | 实例规格的内存大小,单位为GiB。 |
示例
请求示例
http(s)://ess.aliyuncs.com/?Action=DescribeAlarms
&RegionId=cn-hangzhou
&VSwitchId=["vsw-bp14zolna43z266bq****"]
&ZoneId=["cn-hangzhou-g"]
&SpotStrategy=NoSpot
&Cores=2
&Memory=4.0
&MaxPrice=2.0
&InstanceFamilyLevel=EnterpriseLevel
&ExcludedInstanceType=["ecs.c6.xlarge"]
&Architecture=["X86"]
&BurstablePerformance=Include
&CoresList=[2]
&MemoryList=[4.0]
&ChannelId=79425074
&InstanceTypeFamilies=["ecs.g6"]
&MinimumCpuCoreCount=2
&MaximumCpuCoreCount=4
&GpuSpecs=["NVIDIA V100"]
&InstanceCategories=["Compute-optimized with GPU"]
&CpuArchitectures=["X86"]
&PhysicalProcessorModels=["Intel Xeon(Ice Lake) Platinum 8369B"]
&MinimumEniQuantity=2
&MinimumEniPrivateIpAddressQuantity=2
&MinimumEniIpv6AddressQuantity=1
&MinimumInitialCredit=12
&MinimumBaselineCredit=12
&MinimumMemorySize=4.0
&MaximumMemorySize=4.0
&MinimumGpuAmount=2
&MaximumGpuAmount=2
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePatternTypesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<PatternTypes>
<InstanceType>ecs.c7.xlarge</InstanceType>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<InstanceTypeFamily>ecs.c7</InstanceTypeFamily>
<Cores>4</Cores>
<Memory>8</Memory>
</PatternTypes>
</DescribePatternTypesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"PatternTypes" : [ {
"InstanceType" : "ecs.c7.xlarge",
"InstanceFamilyLevel" : "EnterpriseLevel",
"InstanceTypeFamily" : "ecs.c7",
"Cores" : 4,
"Memory" : 8
} ]
}
错误码
访问错误中心查看更多错误码。