すべてのプロダクト
Search
ドキュメントセンター

PolarDB:CreateResourceControl

最終更新日:Jul 29, 2026

指定された PolarDB for MySQL クラスターのリソースコントロールルールを作成します。MaxCpu をセットしてルールが使用できる CPU クォータの最大値パーセンテージを指定するか、CpuCount をセットしてルールが使用できる CPU コアの最大値数を指定できます。ルール作成時は、MaxCpu と CpuCount のいずれか一方のみを指定する必要があります。

操作説明

Resource Control は、PolarDB for MySQL クラスター内の指定されたユーザー、データベース、クエリ、または接続が使用できる CPU リソースを制限します。このリリースでは、リソースコントロールルールの作成、変更、削除、バインド、およびバインド解除がサポートされています。Resource Control の CPU 使用量の照会はサポートされていません。

開始する前に

  • この特徴は、Resource Control をサポートする PolarDB for MySQL Cluster Edition クラスターにのみ適用されます。PolarDB for MySQL Standard Edition はサポートされていません。

  • クラスターのカーネルパラメーター loose_enable_resource_control が ON に設定されている必要があります。

  • MaxCpu と CpuCount は相互排他的な 2 つの CPU クォータモードです。

  • CpuCount の最大値は、対象クラスターのカーネルパラメーター resource_control_cpu_count_limit によって決定されます。

重要 これは通知です。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

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

応答スキーマ。

RequestId

string

リクエストの ID。

C61892A4-0850-4516-9E26-44D96C1782DE

成功レスポンス

JSONJSON

{
  "RequestId": "C61892A4-0850-4516-9E26-44D96C1782DE"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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 は現在のレコードに存在しません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。