调用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

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

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

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

  • 当BeginDate和EndDate取值均为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

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

  • Resource：cpu、memory的指标取值。
  • Pods：tcpActiveConn的指标取值。
  • External：arms、slb的指标取值。
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"
    } ]
  }
}

错误码

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