全部產品
Search
文件中心

PolarDB:BindResourceControl

更新時間:Jul 29, 2026

將指定的資源控制規則綁定到 PolarDB MySQL 叢集中的使用者、資料庫、查詢或連線。綁定成功後,目標物件將受到該資源控制規則的 CPU 配額限制。

介面說明

Resource Control 用於限制 PolarDB MySQL 叢集中指定使用者、資料庫、查詢或連線可使用的 CPU 資源。本期開放建立、修改、刪除、綁定和解綁能力,不提供 Resource Control CPU 使用率查詢功能。

使用限制

  • 僅適用於支援 Resource Control 的 PolarDB MySQL 叢集版,PolarDB MySQL 標準版不支援。

  • 叢集核心參數 loose_enable_resource_control 必須設定為 ON。

重要 這是注意的內容

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

PolarDB 叢集所在地域的 ID。

說明

可透過介面 DescribeRegions 檢視可用的地域。

cn-beijing

DBClusterId

string

PolarDB 叢集 ID。

pc-**************

ResourceControlName

string

資源控制規則名稱。長度為 1~63 個 ASCII 位元組,必須以英文字母開頭,僅支援英文字母、數字和底線。

test_rc

TargetType

string

綁定目標的類型。取值:USER、DATABASE、QUERY、CONNECTION,大小寫不敏感。

USER

TargetValue

string

綁定目標的值。具體格式由 TargetType 決定,請參閱下表。

app_user

TargetValue 取值規則:

TargetTypeTargetValue 說明範例值
USER資料庫使用者名稱。長度為 1~63 個 ASCII 位元組,必須以英文字母開頭,僅支援英文字母、數字和底線。不支援包含 Host、萬用字元或引用符號的帳號。app_user
DATABASE資料庫名稱。長度為 1~63 個 ASCII 位元組,必須以英文字母開頭,僅支援英文字母、數字和底線。order_db
QUERY查詢 ID。必須是不含符號、空格和前導零的十進位正整數,取值範圍為 1~Long.MAX_VALUE。12345
CONNECTION連線 ID。必須是不含符號、空格和前導零的十進位正整數,取值範圍為 1~Long.MAX_VALUE。67890

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

6BD9CDE4-5E7B-4BF3-9BB8-83C73E******

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6BD9CDE4-5E7B-4BF3-9BB8-83C73E******"
}

錯誤碼

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。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情