为指定的 PolarDB MySQL 集群创建资源控制规则。您可以通过 MaxCpu 设置规则可使用的最大 CPU 配额百分比，或者通过 CpuCount 设置规则可使用的最大 CPU 核数。 创建时必须且只能指定 MaxCpu 和 CpuCount 中的一个参数。
接口说明
Resource Control 用于限制 PolarDB MySQL 集群中指定用户、数据库、查询或连接可使用的 CPU 资源。本期开放创建、修改、删除、绑定和解绑能力，不提供 Resource Control CPU 使用率查询能力。
使用限制
仅适用于支持 Resource Control 的 PolarDB MySQL 集群版，PolarDB MySQL 标准版不支持。
集群内核参数 loose_enable_resource_control 必须设置为 ON。
MaxCpu 和 CpuCount 是两种互斥的 CPU 配额模式。
CpuCount 的最大值由目标集群内核参数 resource_control_cpu_count_limit 决定。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
PolarDB 集群所在地域的 ID。 说明
您可以通过 DescribeRegions 接口查看可用地域。 |
cn-beijing |
| DBClusterId |
string |
是 |
PolarDB 集群 ID。 |
pc-************** |
| ResourceControlName |
string |
是 |
资源控制规则名称。长度为 1～63 个 ASCII 字节，必须以英文字母开头，仅支持英文字母、数字和下划线。 |
test_rc |
| MaxCpu |
integer |
否 |
资源控制规则可使用的最大 CPU 配额百分比。取值范围为 1～100。与 CpuCount 必须且只能指定一个。 |
20 |
| CpuCount |
integer |
否 |
资源控制规则可使用的最大 CPU 核数。最小值为 1，最大值由集群内核参数 resource_control_cpu_count_limit 决定。与 MaxCpu 必须且只能指定一个。 |
4 |
创建时必须且只能指定 MaxCpu 和 CpuCount 中的一个参数。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
C61892A4-0850-4516-9E26-44D96C1782DE |
示例
正常返回示例
JSON格式
{
"RequestId": "C61892A4-0850-4516-9E26-44D96C1782DE"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameters.Malformed | The specified Resource Control parameter is not valid. | |
| 400 | Database.ConnectError | Unable to connect to the database instance. | |
| 400 | Database.ExecError | The Resource Control operation could not be executed on the database instance. | |
| 403 | IncorrectDBInstanceType | Resource Control is not supported for the current DB cluster edition or kernel configuration. | |
| 403 | AuthorizationFailure | The request is not authorized to operate Resource Control. | |
| 404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的 DBClusterId。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。