文档首页/ 云数据库 RDS/ API参考/ API v3/ 实例管理/ 查询自治限流规则 - QueryAutoSqlLimiting
更新时间:2026-09-20 GMT+08:00
分享

查询自治限流规则 - QueryAutoSqlLimiting

功能介绍

查询自治限流规则。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,需具备如下身份策略权限。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

rds:instance:listAll

read

-

-

rds:instance:list

-

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/ops/auto-sql-limiting

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    参数解释:

    租户在某一region下的project ID。

    获取方法请参见获取项目ID。

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    instance_id

    是

    String

    参数解释:

    实例ID。

    可调用查询数据库实例列表接口,通过表4中的“id”获取。

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

请求消息

无。

请求示例

查询自治限流规则。

GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/ops/auto-sql-limiting

响应消息

  • 正常响应要素说明
    表2 参数说明

    参数

    参数类型

    描述

    cpu_usage

    Integer

    参数解释:

    限流策略CPU利用率(%)。

    取值范围:

    70~100

    active_sessions

    Integer

    参数解释:

    限流策略活跃会话数。

    取值范围:

    1~5000

    condition

    String

    参数解释:

    限流策略CPU利用率和活跃会话数的关联关系。

    取值范围:

    • and:且。
    • or:或。

    duration

    Integer

    参数解释:

    限流策略满足限流条件的事件持续时间(分钟)。

    取值范围:

    5、15、30。

    start_time

    String

    参数解释:

    自治限流规则每天生效开始时间。格式为hh:mm,示例00:00。

    取值范围:

    不涉及。

    end_time

    String

    参数解释:

    自治限流规则每天生效结束时间。格式为hh:mm,示例03:00。

    取值范围:

    不涉及。

    session_allow

    Integer

    参数解释:

    允许的会话数。

    取值范围:

    1~5000

    user

    Array of String

    参数解释:

    限流规则适用的用户列表。

    db

    Array of String

    参数解释:

    限流规则适用的数据库列表。

    clear_time

    Integer

    参数解释:

    每次最大限流时长(分钟)。

    取值范围:

    1、5、10、15。

    enable

    Boolean

    参数解释:

    是否启用自治限流规则。

    取值范围:

    • true:启用自治限流规则。
    • false:不启用自治限流规则。

    is_keyword

    Boolean

    参数解释:

    是否为关键字限流。

    取值范围:

    • true:关键字限流。
    • false:非关键字限流。

    max_concurrency

    Integer

    参数解释:

    最大并发数。

    取值范围:

    0~50000

    retain_sql_rule

    Boolean

    参数解释:

    是否保留SQL限流规则。

    取值范围:

    • true:保留SQL限流规则。
    • false:不保留SQL限流规则。

    kill_session_switch

    Boolean

    参数解释:

    是否开启kill会话开关。

    取值范围:

    • true:开启kill会话开关。
    • false:不开启kill会话开关。
  • 正常响应样例
    {
      "condition": "and",
      "user": [
        "root"
      ],
      "db": [
        "postgres"
      ],
      "enable": true,
      "cpu_usage": 70,
      "active_sessions": 5000,
      "duration": 15,
      "start_time": "00:00",
      "end_time": "03:00",
      "session_allow": 5000,
      "clear_time": 1
    }

状态码

错误码

请参见错误码。

相关文档