DescribeApplicationScalingRule - DescribeApplicationScalingRule -

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

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
sae:DescribeApplicationScalingRule	get	全部资源 *	无	无

请求语法

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

请求参数

名称	类型	必填	描述	示例值
AppId	string	是	应用 ID。	a0d2e04c-159d-40a8-b240-d2f2c263****
ScalingRuleName	string	是	弹性伸缩策略名称。	test

返回参数

名称	类型	描述	示例值
	object	返回信息。
RequestId	string	请求 ID。	73404D3D-EE4F-4CB2-B197-5C46F6A1****
TraceId	string	调用链 ID，用于精确查询调用信息。	0b57ff7e16243300839193068e****
Data	object	返回结果。
Timer	object	定时弹性伸缩。
EndDate	string	定时弹性伸缩策略的短期结束日期。取值说明如下：当 BeginDate 和 EndDate 取值均为 null 时，表示长期执行，为默认值。当取值为具体日期时，例如 BeginDate 为2021-03-25，EndDate 为2021-04-25，表示执行有效期为 1 个月。	2021-04-25
BeginDate	string	定时弹性伸缩策略的短期起始日期。取值说明如下：当 BeginDate 和 EndDate 取值均为 null 时，表示长期执行，为默认值。当取值为具体日期时，例如 BeginDate 为2021-03-25，EndDate 为2021-04-25，表示执行有效期为 1 个月。	2021-03-25
Schedules	array<object>	单天内触发时间点。
Schedule	object	时间点数据。
AtTime	string	时间点。格式：时:分。	08:00
TargetReplicas	integer	目标实例数。	2
MinReplicas	integer	最小实例数。	1
MaxReplicas	integer	最大实例数。	10
Period	string	执行定时弹性伸缩策略的周期。取值说明如下： *** * **：每天指定时间执行定时策略。 * Fri,Mon：每周指定天数的指定时间执行定时策略，支持多选，GMT+8 时区。取值说明如下： Sun：星期日 Mon：星期一 Tue：星期二 Wed：星期三 Thu：星期四 Fri：星期五 Sat：星期六 1,2,3,28,31 * *：每月指定日期的指定时间执行定时策略，支持多选。取值范围[1,31]。若当月无 31 日，则跳过该日期执行定时策略。	* * *
UpdateTime	long	弹性伸缩策略更新时间。单位：毫秒。	1624330075827
AppId	string	应用 ID。	a0d2e04c-159d-40a8-b240-d2f2c263****
CreateTime	long	弹性伸缩策略创建时间。单位：毫秒。	1624329843790
LastDisableTime	long	最近一次禁用弹性伸缩策略的时间。	1641882854484
ScaleRuleEnabled	boolean	弹性伸缩策略是否启用。取值说明如下： true：启用状态。 false：禁用状态。	true
ScaleRuleType	string	弹性伸缩策略类型。取值说明如下： timing：定时弹性。 metric：监控指标弹性。 mix：混合弹性。	timing
Metric	object	监控指标弹性伸缩。
Metrics	array<object>	监控指标弹性伸缩列表。
Metric	object	监控指标数据。
MetricTargetAverageUtilization	integer	监控指标的目标值。 CPU 使用率目标值，单位为百分比。内存使用率目标值，单位为百分比。 QPS，单位为秒。响应时间，单位为毫秒。 TCP 活跃连接数平均值，单位为个/秒。公网 SLB QPS，单位为秒。公网 SLB 响应时间，单位为毫秒。私网 SLB QPS，单位为秒。私网 SLB 响应时间，单位为毫秒。	20
MetricType	string	监控指标的触发条件。取值说明如下： CPU：CPU 使用率。 MEMORY：内存使用率。 QPS：JAVA 应用 1 分钟内单个实例的平均 QPS。 RT：JAVA 应用 1 分钟内应用所有服务接口平均 RT 值。 tcpActiveConn：30 秒内单个实例的平均 TCP 活跃连接数。 SLB_QPS：15 秒内单个实例的平均公网 SLB QPS。 SLB_RT：15 秒内公网 SLB 平均响应时间。 INTRANET_SLB_QPS：15 秒内单个实例的平均私网 SLB QPS。 INTRANET_SLB_RT：15 秒内私网 SLB 平均响应时间。	CPU
SlbProject	string	SLB 访问日志 Project。	test
SlbLogstore	string	SLB 访问日志 Logstore。	test
Vport	string	SLB 实例端口。	80
SlbId	string	SLB 实例 ID。	lb-xxx
MetricsStatus	object	监控指标弹性状态。
DesiredReplicas	long	目标实例数。	2
NextScaleTimePeriod	integer	下一次监控指标弹性的周期。	3
CurrentReplicas	long	当前实例数。	2
LastScaleTime	string	最近一次弹性扩缩的时间。	2022-01-11T08:14:32Z
CurrentMetrics	array<object>	当前监控指标弹性数据。
CurrentMetric	object	监控指标数据。
Type	string	数据类型。与监控指标关联。 Resource：cpu、memory 的指标取值。 Pods：tcpActiveConn 的指标取值。 External：arms、slb 的指标取值。	Resource
CurrentValue	long	当前值。	0
Name	string	触发条件的名称。 cpu：CPU 使用率。 memory：内存使用率。 arms_incall_rt：JAVA 应用 1 分钟内单个实例的平均 QPS。 arms_incall_rt：JAVA 应用 1 分钟内应用所有服务接口平均 RT 值。 tcpActiveConn：TCP 活跃连接数。 slb_incall_qps：公网 SLB QPS。 slb_incall_rt：公网 SLB 响应时间。 intranet_slb_incall_qps：私网 SLB QPS。 intranet_slb_incall_rt：私网 SLB 响应时间。	cpu
NextScaleMetrics	array<object>	下一次监控指标弹性列表。
NextScaleMetric	object	监控指标数据。
NextScaleOutAverageUtilization	integer	下一次触发扩容条件的监控指标弹性的百分比数值。	21
NextScaleInAverageUtilization	integer	下一次触发缩容条件的监控指标弹性的百分比数值。	10
Name	string	触发条件的名称。 cpu：CPU 使用率。 memory：内存使用率。 arms_incall_rt：JAVA 应用 1 分钟内单个实例的平均 QPS。 arms_incall_rt：JAVA 应用 1 分钟内应用所有服务接口平均 RT 值。 tcpActiveConn：TCP 活跃连接数。 slb_incall_qps：公网 SLB QPS。 slb_incall_rt：公网 SLB 响应时间。 intranet_slb_incall_qps：私网 SLB QPS。 intranet_slb_incall_rt：私网 SLB 响应时间。	cpu
MaxReplicas	integer	最大实例数。	3
MinReplicas	integer	最小实例数。	1
ScaleUpRules	object	应用扩容规则。
Step	long	弹性扩容步长。单位时间内最多扩容的实例数。	100
StabilizationWindowSeconds	long	扩容冷却时间。取值范围[0, 3600]，单位为秒。默认为 0 秒。	300
Disabled	boolean	是否禁止缩容。取值说明如下： true：开启。 false：关闭。说明开启后将永远不会缩容该应用的实例，能有效防止在流量高峰期缩容造成业务风险。默认关闭。	false
ScaleDownRules	object	应用缩容规则。
Step	long	弹性缩容步长。单位时间内最多缩容的实例数。	100
StabilizationWindowSeconds	long	缩容冷却时间。取值范围[0, 3600]，单位为秒。默认为 0 秒。	300
Disabled	boolean	是否禁止缩容。取值说明如下： true：开启。 false：关闭。说明开启后将永远不会缩容该应用的实例，能有效防止在流量高峰期缩容造成业务风险。默认关闭。	false
ScaleRuleName	string	弹性伸缩策略名称。	test
Message	string	附加信息。取值说明如下：请求正常，返回 success。请求异常，返回具体异常错误码。	success
ErrorCode	string	错误码。取值说明如下：请求成功：不返回 ErrorCode 字段。请求失败：返回 ErrorCode 字段。具体信息，请参见本文的错误码列表。	空
Code	string	接口状态或 POP 错误码。取值说明如下： 2xx：成功。 3xx：重定向。 4xx：请求错误。 5xx：服务器错误。	200
Success	boolean	重启应用实例是否成功。取值说明如下： true：重启成功。 false：重启失败。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "73404D3D-EE4F-4CB2-B197-5C46F6A1****",
  "TraceId": "0b57ff7e16243300839193068e****",
  "Data": {
    "Timer": {
      "EndDate": "2021-04-25",
      "BeginDate": "2021-03-25",
      "Schedules": [
        {
          "AtTime": "08:00",
          "TargetReplicas": 2,
          "MinReplicas": 1,
          "MaxReplicas": 10
        }
      ],
      "Period": "* * *"
    },
    "UpdateTime": 1624330075827,
    "AppId": "a0d2e04c-159d-40a8-b240-d2f2c263****",
    "CreateTime": 1624329843790,
    "LastDisableTime": 1641882854484,
    "ScaleRuleEnabled": true,
    "ScaleRuleType": "timing",
    "Metric": {
      "Metrics": [
        {
          "MetricTargetAverageUtilization": 20,
          "MetricType": "CPU",
          "SlbProject": "test",
          "SlbLogstore": "test",
          "Vport": "80",
          "SlbId": "lb-xxx"
        }
      ],
      "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,
      "ScaleUpRules": {
        "Step": 100,
        "StabilizationWindowSeconds": 300,
        "Disabled": false
      },
      "ScaleDownRules": {
        "Step": 100,
        "StabilizationWindowSeconds": 300,
        "Disabled": false
      }
    },
    "ScaleRuleName": "test",
    "MinReadyInstances": 0,
    "MinReadyInstanceRatio": 0,
    "EnableIdle": true
  },
  "Message": "success",
  "ErrorCode": "空",
  "Code": "200",
  "Success": true
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-08-30	OpenAPI 返回结构发生变更	查看变更详情
2023-05-31	OpenAPI 返回结构发生变更	查看变更详情
2023-05-24	OpenAPI 返回结构发生变更	查看变更详情
2022-12-19	OpenAPI 返回结构发生变更	查看变更详情