指定された 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 によって決定されます。
今すぐお試しください
テスト
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 は現在のレコードに存在しません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。