# 查询自治限流规则 - QueryAutoSqlLimiting #### 功能介绍 查询自治限流规则。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=QueryAutoSqlLimiting)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | 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](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | instance_id | 是 | String | **参数解释：** 实例ID。 可调用[查询数据库实例列表](https://support.huaweicloud.com/api-rds/rds_01_0004.html)接口，通过[表4](https://support.huaweicloud.com/api-rds/rds_01_0004.html#rds_01_0004__table2058713718267)中的"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 } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。