文档中心

数据库工作台

请输入

SQL 限流

CreateSqlConcurrencyControlRule

调用 CreateSqlConcurrencyControlRule 接口创建 SQL 限流任务。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-383906******	数据库实例 ID。调用 DescribeDBInstances 接口查询 MySQL 的实例 ID。调用 DescribeDBInstances 接口查询 veDB MySQL 的实例 ID。
InstanceType	String	是	MySQL	数据库类型，当前支持的数据库如下所示。 MySQL：云数据库 MySQL 版。 VeDBMySQL：云数据库 veDB MySQL 版。
RegionId	String	是	cn-beijing	地域 ID。
ThrottleTarget	String	是	MaxConcurrencyCount	限流对象，当前仅支持 MaxConcurrencyCount 取值，表示 SQL 关键字限流。
KeyWords	String	是	select~from~test	SQL 关键字。说明您可以调用 DescribeSqlKeywords 接口生成 SQL 关键字。
SqlType	String	是	SELECT	需要限流的 SQL 类型，取值包括 SELECT、UPDATE、DELETE、INSERT、REPLACE。
TerminationType	String	是	Manual	SQL 限流任务结束方式，取值如下： Manual：表示手动结束限流任务。 Auto：表示自动结束限流任务。
ConcurrencyCount	Integer	是	1	每个节点的 SQL 语句的最大并发数，取值范围为 0~99999。说明当 ConcurrencyCount 为 0 时，表示禁止符合条件的 SQL 执行。
EffectiveTime	Integer	否	10	SQL 限流任务的限流时长，取值范围为 1~9999999，单位为分钟。说明在参数 TerminationType 取值设置为 Auto 时，该参数为必填。

返回参数

名称	类型	示例值	描述
RuleId	Integer	2108098738466619392	SQL 限流任务 ID。

请求示例

POST /?Action=CreateSqlConcurrencyControlRule&Version=2018-01-01 HTTP/1.1​
Content-Type: application/json​
Host: dbw.cn-beijing.volcengineapi.com​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/dbw/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
​
{​
    "TerminationType": "Auto",​
    "ConcurrencyCount": 1,​
    "ThrottleTarget": "MaxConcurrencyCount",​
    "SqlType": "SELECT",​
    "KeyWords": "select~from~test",​
    "InstanceId": "mysql-383906******",​
    "InstanceType": "MySQL",​
    "EffectiveTime": 10,​
    "RegionId":"cn-beijing"​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20261008153440FDEC164725BAFD66357F-c1e95d",​
        "Action": "CreateSqlConcurrencyControlRule",​
        "Version": "2018-01-01",​
        "Service": "dbw",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "RuleId": 2108098738466619392​
    }​
}​

错误码

更多详情，请参见错误码。

最近更新时间：2026.10.10 10:39:18

这个页面对您有帮助吗？

有用

无用