指定された PolarDB for MySQL クラスター内の既存リソースコントロールルールの CPU クォータを変更します。現在のクォータ値の変更、または最大値 CPU パーセンテージモードと最大値 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-hangzhou。 |
| DBClusterId |
string |
必須 |
PolarDB クラスターの ID。 |
pc-************** |
| ResourceControlName |
string |
必須 |
リソースコントロールルールの名前。名前は 1~63 ASCII バイトの長さで、先頭は英字である必要があり、英字、数字、アンダースコアのみを含めることができます。 |
test_rc。 |
| MaxCpu |
integer |
任意 |
変更済みの最大値 CPU クォータパーセンテージ。有効な値: 1~100。このパラメーターと CpuCount のうち、いずれか一方のみを指定する必要があります。 |
30 |
| CpuCount |
integer |
任意 |
変更済みの最大値 CPU コア数。最小値は 1 です。最大値はクラスターのカーネルパラメーター resource_control_cpu_count_limit によって決定されます。このパラメーターと MaxCpu のうち、いずれか一方のみを指定する必要があります。 |
8 |
MaxCpu パラメーターと CpuCount パラメーターのうち、いずれか一方のみを指定する必要があります。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
47921222-0D37-4133-8C0D-017DC3****** |
例
成功レスポンス
JSONJSON
{
"RequestId": "47921222-0D37-4133-8C0D-017DC3******"
}
エラーコード
|
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 は現在のレコードに存在しません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。