调用DescribeApplicationScalingRules接口查询应用的多个弹性伸缩策略。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。更多信息,请参见公共请求和返回头

请求语法

GET /pop/v1/sam/scale/applicationScalingRules HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
AppId String Query 7171a6ca-d1cd-4928-8642-7d5cfe69****

应用ID。

返回数据

名称 类型 示例值 描述
RequestId String 91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

请求ID。

TraceId String 0a98a02315955564772843261e****

调用链ID,用于精确查询调用信息。

Data Object

返回结果。

CurrentPage Integer 1

当前页数。

TotalSize Integer 3

应用弹性伸缩策略总数。

PageSize Integer 10

页面大小。

ApplicationScalingRules Array of ApplicationScalingRule

应用弹性伸缩策略列表。

Timer Object

定时弹性伸缩。

EndDate String 2021-04-25

定时弹性伸缩策略的短期结束日期。取值说明如下:

  • BeginDateEndDate取值均为null时,表示长期执行,为默认值。
  • 当取值为具体日期时,例如BeginDate为2021-03-25,EndDate为2021-04-25,表示执行有效期为1个月。
BeginDate String 2021-03-25

定时弹性伸缩策略的短期起始日期。取值说明如下:

  • BeginDateEndDate取值均为null时,表示长期执行,为默认值。
  • 当取值为具体日期时,例如BeginDate为2021-03-25,EndDate为2021-04-25,表示执行有效期为1个月。
Schedules Array of Schedule

单天内触发时间点。

AtTime String 08:00

时间点。格式:时:分

TargetReplicas Integer 3

目标实例数。

MaxReplicas Long 50

最大实例数。

MinReplicas Long 1

最小实例数。

Period String * * *

执行定时弹性伸缩策略的周期。取值说明如下:

  • * * *:每天指定时间执行定时策略。
  • * * Fri,Mon:每周指定天数的指定时间执行定时策略,支持多选,GMT+8时区。取值说明如下:
    • Sun:星期日
    • Mon:星期一
    • Tue:星期二
    • Wed:星期三
    • Thu:星期四
    • Fri:星期五
    • Sat:星期六
  • 1,2,3,28,31 * *:每月指定日期的指定时间执行定时策略,支持多选。取值范围[1,31]。若当月无31日,则跳过该日期执行定时策略。
UpdateTime Long 1616642248938

弹性伸缩策略更新时间。单位:毫秒。

AppId String 7171a6ca-d1cd-4928-8642-7d5cfe69****

应用ID。

CreateTime Long 1616642248938

弹性伸缩策略创建时间。单位:毫秒。

LastDisableTime Long 1641882854484

最近一次禁用弹性伸缩策略的时间。

ScaleRuleEnabled Boolean true

弹性伸缩策略是否启用。取值说明如下:

  • true:启用状态。
  • false:禁用状态。
ScaleRuleType String timing

弹性伸缩策略类型。取值说明如下:

  • timing:定时弹性。
  • metric:监控指标弹性。
  • mix:混合弹性。
Metric Object

监控指标弹性伸缩。

Metrics Array of Metric

监控指标弹性伸缩列表。

MetricTargetAverageUtilization Integer 20

监控指标的目标值。

  • CPU使用率目标值,单位为百分比。
  • 内存使用率目标值,单位为百分比。
  • TCP活跃连接数平均值,单位为个/秒。
  • 公网SLB QPS,单位为秒。
  • 公网SLB响应时间,单位为毫秒。
MetricType String CPU

监控指标触发条件。取值说明如下:

  • CPU:CPU使用率。
  • MEMORY:内存使用率。
  • tcpActiveConn:30秒内单个实例的平均TCP活跃连接数。
  • SLB_QPS:15秒内单个实例的平均公网SLB QPS。
  • SLB_RT:15秒内公网SLB平均响应时间。
MetricsStatus Object

监控指标弹性状态。

DesiredReplicas Long 2

目标实例数。

NextScaleTimePeriod Integer 3

下一次监控指标弹性的周期。

CurrentReplicas Long 2

当前实例数。

LastScaleTime String 2022-01-11T08:14:32Z

最近一次弹性扩缩的时间。

CurrentMetrics Array of CurrentMetric

当前监控指标弹性列表。

Type String Resource

数据类型。与监控指标关联。

  • Resourcecpumemory的指标取值。
  • PodstcpActiveConn的指标取值。
  • Externalarmsslb的指标取值。
CurrentValue Long 0

当前值。

Name String cpu

触发条件的名称。

  • cpu:CPU使用率。
  • memory:内存使用率。
  • tcpActiveConn:TCP活跃连接数。
  • slb_incall_qps:公网SLB QPS。
  • slb_incall_rt:公网SLB响应时间。
NextScaleMetrics Array of NextScaleMetric

下一次监控指标弹性列表。

NextScaleOutAverageUtilization Integer 21

下一次触发扩容条件的监控指标弹性的百分比数值。

NextScaleInAverageUtilization Integer 10

下一次触发缩容条件的监控指标弹性的百分比数值。

Name String cpu

触发条件的名称。

  • cpu:CPU使用率。
  • memory:内存使用率。
  • tcpActiveConn:TCP活跃连接数。
  • slb_incall_qps:公网SLB QPS。
  • slb_incall_rt:公网SLB响应时间。
MaxReplicas Long 3

最大实例数。

MinReplicas Long 1

最小实例数。

MaxReplicas Integer 3

最大实例数。

MinReplicas Integer 1

最小实例数。

ScaleUpRules Object

应用扩容规则。

Step Long 100

弹性扩容步长。单位时间内最多扩容的实例数。

StabilizationWindowSeconds Long 300

扩容冷却时间。取值范围[0, 3600],单位为秒。默认为0秒。

Disabled Boolean false

是否禁止缩容。取值说明如下:

  • true:开启。
  • false:关闭。
说明 开启后将永远不会缩容该应用的实例,能有效防止在流量高峰期缩容造成业务风险。默认关闭。
ScaleDownRules Object

应用缩容规则。

Step Long 100

弹性缩容步长。单位时间内最多缩容的实例数。

StabilizationWindowSeconds Long 300

缩容冷却时间。取值范围[0, 3600],单位为秒。默认为0秒。

Disabled Boolean false

是否禁止缩容。取值说明如下:

  • true:开启。
  • false:关闭。
说明 开启后将永远不会缩容该应用的实例,能有效防止在流量高峰期缩容造成业务风险。默认关闭。
ScaleRuleName String test

弹性伸缩策略名称。

示例

请求示例

GET /pop/v1/sam/scale/applicationScalingRules?AppId=7171a6ca-d1cd-4928-8642-7d5cfe69**** HTTP/1.1
Host:sae.aliyuncs.com
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeApplicationScalingRulesResponse>
    <RequestId>91F93257-7A4A-4BD3-9A7E-2F6EAE6D****</RequestId>
    <TraceId>0a98a02315955564772843261e****</TraceId>
    <Data>
        <CurrentPage>1</CurrentPage>
        <TotalSize>3</TotalSize>
        <PageSize>10</PageSize>
        <ApplicationScalingRules>
            <Timer>
                <EndDate>2021-04-25</EndDate>
                <BeginDate>2021-03-25</BeginDate>
                <Schedules>
                    <AtTime>08:00</AtTime>
                    <TargetReplicas>3</TargetReplicas>
                    <MaxReplicas>50</MaxReplicas>
                    <MinReplicas>1</MinReplicas>
                </Schedules>
                <Period>* * *</Period>
            </Timer>
            <UpdateTime>1616642248938</UpdateTime>
            <AppId>7171a6ca-d1cd-4928-8642-7d5cfe69****</AppId>
            <CreateTime>1616642248938</CreateTime>
            <LastDisableTime>1641882854484</LastDisableTime>
            <ScaleRuleEnabled>true</ScaleRuleEnabled>
            <ScaleRuleType>timing</ScaleRuleType>
            <Metric>
                <Metrics>
                    <MetricTargetAverageUtilization>20</MetricTargetAverageUtilization>
                    <MetricType>CPU</MetricType>
                </Metrics>
                <MetricsStatus>
                    <DesiredReplicas>2</DesiredReplicas>
                    <NextScaleTimePeriod>3</NextScaleTimePeriod>
                    <CurrentReplicas>2</CurrentReplicas>
                    <LastScaleTime>2022-01-11T08:14:32Z</LastScaleTime>
                    <CurrentMetrics>
                        <Type>Resource</Type>
                        <CurrentValue>0</CurrentValue>
                        <Name>cpu</Name>
                    </CurrentMetrics>
                    <NextScaleMetrics>
                        <NextScaleOutAverageUtilization>21</NextScaleOutAverageUtilization>
                        <NextScaleInAverageUtilization>10</NextScaleInAverageUtilization>
                        <Name>cpu</Name>
                    </NextScaleMetrics>
                    <MaxReplicas>3</MaxReplicas>
                    <MinReplicas>1</MinReplicas>
                </MetricsStatus>
                <MaxReplicas>3</MaxReplicas>
                <MinReplicas>1</MinReplicas>
                <ScaleUpRules>
                    <Step>100</Step>
                    <StabilizationWindowSeconds>300</StabilizationWindowSeconds>
                    <Disabled>false</Disabled>
                </ScaleUpRules>
                <ScaleDownRules>
                    <Step>100</Step>
                    <StabilizationWindowSeconds>300</StabilizationWindowSeconds>
                    <Disabled>false</Disabled>
                </ScaleDownRules>
            </Metric>
            <ScaleRuleName>test</ScaleRuleName>
        </ApplicationScalingRules>
    </Data>
</DescribeApplicationScalingRulesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "TraceId" : "0a98a02315955564772843261e****",
  "Data" : {
    "CurrentPage" : 1,
    "TotalSize" : 3,
    "PageSize" : 10,
    "ApplicationScalingRules" : [ {
      "Timer" : {
        "EndDate" : "2021-04-25",
        "BeginDate" : "2021-03-25",
        "Schedules" : [ {
          "AtTime" : "08:00",
          "TargetReplicas" : 3,
          "MaxReplicas" : 50,
          "MinReplicas" : 1
        } ],
        "Period" : "* * *"
      },
      "UpdateTime" : 1616642248938,
      "AppId" : "7171a6ca-d1cd-4928-8642-7d5cfe69****",
      "CreateTime" : 1616642248938,
      "LastDisableTime" : 1641882854484,
      "ScaleRuleEnabled" : true,
      "ScaleRuleType" : "timing",
      "Metric" : {
        "Metrics" : [ {
          "MetricTargetAverageUtilization" : 20,
          "MetricType" : "CPU"
        } ],
        "MetricsStatus" : {
          "DesiredReplicas" : 2,
          "NextScaleTimePeriod" : 3,
          "CurrentReplicas" : 2,
          "LastScaleTime" : "2022-01-11T08:14:32Z",
          "CurrentMetrics" : [ {
            "Type" : "Resource",
            "CurrentValue" : 0,
            "Name" : "cpu"
          } ],
          "NextScaleMetrics" : [ {
            "NextScaleOutAverageUtilization" : 21,
            "NextScaleInAverageUtilization" : 10,
            "Name" : "cpu"
          } ],
          "MaxReplicas" : 3,
          "MinReplicas" : 1
        },
        "MaxReplicas" : 3,
        "MinReplicas" : 1,
        "ScaleUpRules" : {
          "Step" : 100,
          "StabilizationWindowSeconds" : 300,
          "Disabled" : false
        },
        "ScaleDownRules" : {
          "Step" : 100,
          "StabilizationWindowSeconds" : 300,
          "Disabled" : false
        }
      },
      "ScaleRuleName" : "test"
    } ]
  }
}

错误码

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