AI 助理
备案控制台
文档
输入文档关键字查找
首页 弹性伸缩 开发参考 API参考 API参考（2014-08-28） 伸缩配置 DescribePatternTypes

DescribePatternTypes

更新时间：
产品详情
我的收藏

调用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：普通的按量付费实例。
  • SpotWithPriceLimit：设置上限价格的抢占式实例。
  • SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

默认值：NoSpot。
Cores Integer 否 2

实例规格的vCPU内核数目。
Memory Float 否 4

实例规格的内存大小，单位为GiB。
MaxPrice Float 否 2

按量付费实例或者抢占式实例可接受的每小时最高价格。
InstanceFamilyLevel String 否 EnterpriseLevel

实例规格族级别。取值范围：

  • EntryLevel：入门级，即共享型实例规格。成本更低，但是无法保证实例计算性能的稳定。适用于平时CPU使用率低的业务场景。更多信息，请参见共享型。
  • EnterpriseLevel：企业级。性能稳定，资源独享，适用于对稳定性要求高的业务场景。更多信息，请参见实例规格族。
  • CreditEntryLevel：积分入门级，即突发性能实例。通过CPU积分来保证计算性能，适用于平时CPU使用率低、偶有突发CPU使用率的情况。更多信息，请参见突发性能实例。
ExcludedInstanceType.N String 否 ecs.c6.xlarge

需要排除的实例规格。通过使用通配符（*）可以排除单个规格或者整个规格族。例如：

  • ecs.c6.large：表示排除ecs.c6.large实例规格。
  • ecs.c6.*：表示排除整个c6规格族的实例规格。
说明 如果需要排除多个实例规格，请使用分隔符（/）隔开单个实例规格。例如ecs.n1.small/ecs.n1.*/*7*。
Architecture.N String 否 X86

实例规格所属的架构类型。取值范围：

  • X86：X86计算。
  • Heterogeneous：异构计算，例如GPU或FPGA等。
  • BareMental：弹性裸金属服务器。
  • Arm：Arm计算。

默认值：包含所有架构类型。
BurstablePerformance String 否 Include

是否为性能突发实例规格。取值范围：

  • Exclude：不包含性能突发实例规格。
  • Include：包含性能突发实例规格。
  • Required：只包含性能突发实例规格。

默认值：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

实例规格分类。取值范围：

  • General-purpose： 通用型。
  • Compute-optimized：计算型。
  • Memory-optimized：内存型。
  • Big data：大数据型。
  • Local SSDs ：本地 SSD 型。
  • High Clock Speed ：高主频型。
  • Enhanced ：增强型。
  • Shared：共享型。
  • Compute-optimized with GPU ：GPU 计算型。
  • Visual Compute-optimized ：视觉计算型。
  • Heterogeneous Service ：异构服务型。
  • Compute-optimized with FPGA ：FPGA 计算型。
  • Compute-optimized with NPU ：NPU 计算型。
  • ECS Bare Metal ：弹性裸金属服务器。
  • High Performance Compute：高性能计算型。
CpuArchitectures.N String 否 X86

实例规格的CPU架构。取值范围：

说明 N表示可以设置多个CPU架构，N的取值范围：1~2。
  • X86。
  • ARM。
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

实例规格族级别。可能值：

  • EntryLevel：入门级，即共享型实例规格。成本更低，但是无法保证实例计算性能的稳定。适用于平时CPU使用率低的业务场景。更多信息，请参见共享型。
  • EnterpriseLevel：企业级。性能稳定，资源独享，适用于对稳定性要求高的业务场景。更多信息，请参见实例规格族。
  • CreditEntryLevel：积分入门级，即突发性能实例。通过CPU积分来保证计算性能，适用于平时CPU使用率低、偶有突发CPU使用率的情况。更多信息，请参见突发性能实例。
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
  } ]
}

错误码

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

上一篇：DeleteEciScalingConfiguration下一篇：伸缩规则
文档推荐