PolarDB for MySQL クラスター内のユーザー、データベース、クエリ、または接続に指定されたリソースコントロールルールをバインドします。バインドが成功すると、対象オブジェクトはリソースコントロールルールで定義された CPU クォータ制限の対象となります。
操作説明
Resource Control は、PolarDB for MySQL クラスター内の指定されたユーザー、データベース、クエリ、または接続が使用できる CPU リソースを制限します。このリリースでは、リソースコントロールルールの作成、変更、削除、バインド、およびバインド解除がサポートされています。Resource Control の CPU 使用量の照会はサポートされていません。
開始する前に
この特徴は、Resource Control をサポートする PolarDB for MySQL Cluster Edition クラスターにのみ適用されます。PolarDB for MySQL Standard エディションはサポートされていません。
クラスターのカーネルパラメーター loose_enable_resource_control が ON に設定されている必要があります。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
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 のルール:
| TargetType | TargetValue の説明 | 例 |
| USER | データベースのユーザー名。名前は 1～63 ASCII バイトの長さで、英字で始まり、英字、数字、アンダースコアのみを含めることができます。ホスト、ワイルドカード、または引用符を含むアカウントはサポートされていません。 | app_user |
| DATABASE | データベース名。名前は 1～63 ASCII バイトの長さで、英字で始まり、英字、数字、アンダースコアのみを含めることができます。 | order_db |
| QUERY | クエリ ID。値は符号、スペース、先行ゼロなしの正の 10 進整数である必要があります。有効な値: 1 ～ Long.MAX_VALUE。 | 12345 |
| CONNECTION | 接続 ID。値は符号、スペース、先行ゼロなしの正の 10 進整数である必要があります。有効な値: 1 ～ Long.MAX_VALUE。 | 67890 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
6BD9CDE4-5E7B-4BF3-9BB8-83C73E****** |
例
成功レスポンス
JSONJSON
{
"RequestId": "6BD9CDE4-5E7B-4BF3-9BB8-83C73E******"
}エラーコード
|
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 は現在のレコードに存在しません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。