@alicloud/polardb20170801 7.10.0 → 7.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/dist/client.d.ts +113 -26
  2. package/dist/client.js +191 -26
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/BindResourceControlRequest.d.ts +9 -9
  5. package/dist/models/CreateAidbclusterApiKeyRequest.d.ts +33 -0
  6. package/dist/models/CreateAidbclusterApiKeyRequest.js +60 -0
  7. package/dist/models/CreateAidbclusterApiKeyRequest.js.map +1 -0
  8. package/dist/models/CreateAidbclusterApiKeyResponse.d.ts +19 -0
  9. package/dist/models/CreateAidbclusterApiKeyResponse.js +69 -0
  10. package/dist/models/CreateAidbclusterApiKeyResponse.js.map +1 -0
  11. package/dist/models/CreateAidbclusterApiKeyResponseBody.d.ts +78 -0
  12. package/dist/models/CreateAidbclusterApiKeyResponseBody.js +90 -0
  13. package/dist/models/CreateAidbclusterApiKeyResponseBody.js.map +1 -0
  14. package/dist/models/CreateResourceControlRequest.d.ts +8 -8
  15. package/dist/models/DeleteAidbclusterApiKeyRequest.d.ts +34 -0
  16. package/dist/models/DeleteAidbclusterApiKeyRequest.js +60 -0
  17. package/dist/models/DeleteAidbclusterApiKeyRequest.js.map +1 -0
  18. package/dist/models/DeleteAidbclusterApiKeyResponse.d.ts +19 -0
  19. package/dist/models/DeleteAidbclusterApiKeyResponse.js +69 -0
  20. package/dist/models/DeleteAidbclusterApiKeyResponse.js.map +1 -0
  21. package/dist/models/DeleteAidbclusterApiKeyResponseBody.d.ts +29 -0
  22. package/dist/models/DeleteAidbclusterApiKeyResponseBody.js +60 -0
  23. package/dist/models/DeleteAidbclusterApiKeyResponseBody.js.map +1 -0
  24. package/dist/models/DeleteResourceControlRequest.d.ts +6 -5
  25. package/dist/models/DeleteResourceControlRequest.js.map +1 -1
  26. package/dist/models/DescribeAidbclusterApiKeysRequest.d.ts +23 -0
  27. package/dist/models/DescribeAidbclusterApiKeysRequest.js +58 -0
  28. package/dist/models/DescribeAidbclusterApiKeysRequest.js.map +1 -0
  29. package/dist/models/DescribeAidbclusterApiKeysResponse.d.ts +19 -0
  30. package/dist/models/DescribeAidbclusterApiKeysResponse.js +69 -0
  31. package/dist/models/DescribeAidbclusterApiKeysResponse.js.map +1 -0
  32. package/dist/models/DescribeAidbclusterApiKeysResponseBody.d.ts +78 -0
  33. package/dist/models/DescribeAidbclusterApiKeysResponseBody.js +90 -0
  34. package/dist/models/DescribeAidbclusterApiKeysResponseBody.js.map +1 -0
  35. package/dist/models/ModifyResourceControlRequest.d.ts +9 -9
  36. package/dist/models/UnbindResourceControlRequest.d.ts +11 -11
  37. package/dist/models/model.d.ts +11 -0
  38. package/dist/models/model.js +57 -35
  39. package/dist/models/model.js.map +1 -1
  40. package/package.json +1 -1
  41. package/src/client.ts +202 -26
  42. package/src/models/BindResourceControlRequest.ts +9 -9
  43. package/src/models/CreateAidbclusterApiKeyRequest.ts +48 -0
  44. package/src/models/CreateAidbclusterApiKeyResponse.ts +40 -0
  45. package/src/models/CreateAidbclusterApiKeyResponseBody.ts +114 -0
  46. package/src/models/CreateResourceControlRequest.ts +8 -8
  47. package/src/models/DeleteAidbclusterApiKeyRequest.ts +49 -0
  48. package/src/models/DeleteAidbclusterApiKeyResponse.ts +40 -0
  49. package/src/models/DeleteAidbclusterApiKeyResponseBody.ts +44 -0
  50. package/src/models/DeleteResourceControlRequest.ts +6 -5
  51. package/src/models/DescribeAidbclusterApiKeysRequest.ts +36 -0
  52. package/src/models/DescribeAidbclusterApiKeysResponse.ts +40 -0
  53. package/src/models/DescribeAidbclusterApiKeysResponseBody.ts +114 -0
  54. package/src/models/ModifyResourceControlRequest.ts +9 -9
  55. package/src/models/UnbindResourceControlRequest.ts +11 -11
  56. package/src/models/model.ts +11 -0
package/src/client.ts CHANGED
@@ -788,11 +788,14 @@ export default class Client extends OpenApi {
788
788
  }
789
789
 
790
790
  /**
791
- * Associates resource control.
791
+ * Binds a specified resource control rule to a user, database, query, or connection in a PolarDB for MySQL cluster. After the binding succeeds, the target object is subject to the CPU quota limit defined by the resource control rule.
792
792
  *
793
793
  * @remarks
794
- * ## Operation description
795
- * This API operation associates an agent (specified by `AgentId`) of PolarClaw (identified by `ApplicationId`) with a specified communication channel (`Channel`). You can also specify an account ID (`ChannelAccountId`) within the channel.
794
+ * Resource Control limits the CPU resources that can be used by specified users, databases, queries, or connections in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. Querying Resource Control CPU usage is not supported.
795
+ * ### Before you begin
796
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
797
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
798
+ * >Notice: This is a notice.</notice>
796
799
  *
797
800
  * @param request - BindResourceControlRequest
798
801
  * @param runtime - runtime options for this request RuntimeOptions
@@ -839,11 +842,14 @@ export default class Client extends OpenApi {
839
842
  }
840
843
 
841
844
  /**
842
- * Associates resource control.
845
+ * Binds a specified resource control rule to a user, database, query, or connection in a PolarDB for MySQL cluster. After the binding succeeds, the target object is subject to the CPU quota limit defined by the resource control rule.
843
846
  *
844
847
  * @remarks
845
- * ## Operation description
846
- * This API operation associates an agent (specified by `AgentId`) of PolarClaw (identified by `ApplicationId`) with a specified communication channel (`Channel`). You can also specify an account ID (`ChannelAccountId`) within the channel.
848
+ * Resource Control limits the CPU resources that can be used by specified users, databases, queries, or connections in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. Querying Resource Control CPU usage is not supported.
849
+ * ### Before you begin
850
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
851
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
852
+ * >Notice: This is a notice.</notice>
847
853
  *
848
854
  * @param request - BindResourceControlRequest
849
855
  * @returns BindResourceControlResponse
@@ -2055,6 +2061,52 @@ export default class Client extends OpenApi {
2055
2061
  return await this.createAIDBClusterWithOptions(request, runtime);
2056
2062
  }
2057
2063
 
2064
+ /**
2065
+ * Creates a model service API key.
2066
+ *
2067
+ * @param request - CreateAIDBClusterApiKeyRequest
2068
+ * @param runtime - runtime options for this request RuntimeOptions
2069
+ * @returns CreateAIDBClusterApiKeyResponse
2070
+ */
2071
+ async createAIDBClusterApiKeyWithOptions(request: $_model.CreateAIDBClusterApiKeyRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateAIDBClusterApiKeyResponse> {
2072
+ request.validate();
2073
+ let query = { };
2074
+ if (!$dara.isNull(request.description)) {
2075
+ query["Description"] = request.description;
2076
+ }
2077
+
2078
+ if (!$dara.isNull(request.regionId)) {
2079
+ query["RegionId"] = request.regionId;
2080
+ }
2081
+
2082
+ let req = new $OpenApiUtil.OpenApiRequest({
2083
+ query: OpenApiUtil.query(query),
2084
+ });
2085
+ let params = new $OpenApiUtil.Params({
2086
+ action: "CreateAIDBClusterApiKey",
2087
+ version: "2017-08-01",
2088
+ protocol: "HTTPS",
2089
+ pathname: "/",
2090
+ method: "POST",
2091
+ authType: "AK",
2092
+ style: "RPC",
2093
+ reqBodyType: "formData",
2094
+ bodyType: "json",
2095
+ });
2096
+ return $dara.cast<$_model.CreateAIDBClusterApiKeyResponse>(await this.callApi(params, req, runtime), new $_model.CreateAIDBClusterApiKeyResponse({}));
2097
+ }
2098
+
2099
+ /**
2100
+ * Creates a model service API key.
2101
+ *
2102
+ * @param request - CreateAIDBClusterApiKeyRequest
2103
+ * @returns CreateAIDBClusterApiKeyResponse
2104
+ */
2105
+ async createAIDBClusterApiKey(request: $_model.CreateAIDBClusterApiKeyRequest): Promise<$_model.CreateAIDBClusterApiKeyResponse> {
2106
+ let runtime = new $dara.RuntimeOptions({ });
2107
+ return await this.createAIDBClusterApiKeyWithOptions(request, runtime);
2108
+ }
2109
+
2058
2110
  /**
2059
2111
  * Creates a dataset.
2060
2112
  *
@@ -6064,11 +6116,16 @@ export default class Client extends OpenApi {
6064
6116
  }
6065
6117
 
6066
6118
  /**
6067
- * Creates a resource control.
6119
+ * Creates a resource control rule for a specified PolarDB for MySQL cluster. You can set MaxCpu to specify the maximum CPU quota percentage that the rule can use, or set CpuCount to specify the maximum number of CPU cores that the rule can use. You must specify one and only one of MaxCpu and CpuCount when creating a rule.
6068
6120
  *
6069
6121
  * @remarks
6070
- * ## Operation description
6071
- * You can call this operation to define and create a cron job. The cron job is triggered periodically based on a specified schedule and carries specific messages or instructions. Advanced options such as custom execution frequency, time zone settings, and alert mechanisms for failures are supported. You can also configure the message content, target channel, and recipients.
6122
+ * Resource Control limits the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. Querying Resource Control CPU usage is not supported.
6123
+ * ### Before you begin
6124
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
6125
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
6126
+ * - MaxCpu and CpuCount are two mutually exclusive CPU quota modes.
6127
+ * - The maximum value of CpuCount is determined by the kernel parameter resource_control_cpu_count_limit of the target cluster.
6128
+ * >Notice: This is a notice.</notice>
6072
6129
  *
6073
6130
  * @param request - CreateResourceControlRequest
6074
6131
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6115,11 +6172,16 @@ export default class Client extends OpenApi {
6115
6172
  }
6116
6173
 
6117
6174
  /**
6118
- * Creates a resource control.
6175
+ * Creates a resource control rule for a specified PolarDB for MySQL cluster. You can set MaxCpu to specify the maximum CPU quota percentage that the rule can use, or set CpuCount to specify the maximum number of CPU cores that the rule can use. You must specify one and only one of MaxCpu and CpuCount when creating a rule.
6119
6176
  *
6120
6177
  * @remarks
6121
- * ## Operation description
6122
- * You can call this operation to define and create a cron job. The cron job is triggered periodically based on a specified schedule and carries specific messages or instructions. Advanced options such as custom execution frequency, time zone settings, and alert mechanisms for failures are supported. You can also configure the message content, target channel, and recipients.
6178
+ * Resource Control limits the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. Querying Resource Control CPU usage is not supported.
6179
+ * ### Before you begin
6180
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
6181
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
6182
+ * - MaxCpu and CpuCount are two mutually exclusive CPU quota modes.
6183
+ * - The maximum value of CpuCount is determined by the kernel parameter resource_control_cpu_count_limit of the target cluster.
6184
+ * >Notice: This is a notice.</notice>
6123
6185
  *
6124
6186
  * @param request - CreateResourceControlRequest
6125
6187
  * @returns CreateResourceControlResponse
@@ -6307,6 +6369,52 @@ export default class Client extends OpenApi {
6307
6369
  return await this.deleteAIDBClusterWithOptions(request, runtime);
6308
6370
  }
6309
6371
 
6372
+ /**
6373
+ * Deletes an API key for a model service.
6374
+ *
6375
+ * @param request - DeleteAIDBClusterApiKeyRequest
6376
+ * @param runtime - runtime options for this request RuntimeOptions
6377
+ * @returns DeleteAIDBClusterApiKeyResponse
6378
+ */
6379
+ async deleteAIDBClusterApiKeyWithOptions(request: $_model.DeleteAIDBClusterApiKeyRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteAIDBClusterApiKeyResponse> {
6380
+ request.validate();
6381
+ let query = { };
6382
+ if (!$dara.isNull(request.apiKey)) {
6383
+ query["ApiKey"] = request.apiKey;
6384
+ }
6385
+
6386
+ if (!$dara.isNull(request.regionId)) {
6387
+ query["RegionId"] = request.regionId;
6388
+ }
6389
+
6390
+ let req = new $OpenApiUtil.OpenApiRequest({
6391
+ query: OpenApiUtil.query(query),
6392
+ });
6393
+ let params = new $OpenApiUtil.Params({
6394
+ action: "DeleteAIDBClusterApiKey",
6395
+ version: "2017-08-01",
6396
+ protocol: "HTTPS",
6397
+ pathname: "/",
6398
+ method: "POST",
6399
+ authType: "AK",
6400
+ style: "RPC",
6401
+ reqBodyType: "formData",
6402
+ bodyType: "json",
6403
+ });
6404
+ return $dara.cast<$_model.DeleteAIDBClusterApiKeyResponse>(await this.callApi(params, req, runtime), new $_model.DeleteAIDBClusterApiKeyResponse({}));
6405
+ }
6406
+
6407
+ /**
6408
+ * Deletes an API key for a model service.
6409
+ *
6410
+ * @param request - DeleteAIDBClusterApiKeyRequest
6411
+ * @returns DeleteAIDBClusterApiKeyResponse
6412
+ */
6413
+ async deleteAIDBClusterApiKey(request: $_model.DeleteAIDBClusterApiKeyRequest): Promise<$_model.DeleteAIDBClusterApiKeyResponse> {
6414
+ let runtime = new $dara.RuntimeOptions({ });
6415
+ return await this.deleteAIDBClusterApiKeyWithOptions(request, runtime);
6416
+ }
6417
+
6310
6418
  /**
6311
6419
  * Deletes a dataset.
6312
6420
  *
@@ -8960,10 +9068,14 @@ export default class Client extends OpenApi {
8960
9068
  }
8961
9069
 
8962
9070
  /**
8963
- * Deletes a resource control.
9071
+ * Deletes a resource control rule from a specified PolarDB for MySQL cluster.
8964
9072
  *
8965
9073
  * @remarks
8966
- * > The cluster must be in the Running state. Otherwise, the operation fails.
9074
+ * Resource Control is used to limit the CPU resources available to specified users, databases, queries, or connections in a PolarDB for MySQL cluster. This release supports the create, update, delete, attach, and detach operations for resource control rules. Querying Resource Control CPU usage is not supported.
9075
+ * ### Limits
9076
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
9077
+ * - In the cluster kernel parameter Settings, loose_enable_resource_control must be set to ON.
9078
+ * >Notice: This is a notice.</notice>
8967
9079
  *
8968
9080
  * @param request - DeleteResourceControlRequest
8969
9081
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9002,10 +9114,14 @@ export default class Client extends OpenApi {
9002
9114
  }
9003
9115
 
9004
9116
  /**
9005
- * Deletes a resource control.
9117
+ * Deletes a resource control rule from a specified PolarDB for MySQL cluster.
9006
9118
  *
9007
9119
  * @remarks
9008
- * > The cluster must be in the Running state. Otherwise, the operation fails.
9120
+ * Resource Control is used to limit the CPU resources available to specified users, databases, queries, or connections in a PolarDB for MySQL cluster. This release supports the create, update, delete, attach, and detach operations for resource control rules. Querying Resource Control CPU usage is not supported.
9121
+ * ### Limits
9122
+ * - This feature applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
9123
+ * - In the cluster kernel parameter Settings, loose_enable_resource_control must be set to ON.
9124
+ * >Notice: This is a notice.</notice>
9009
9125
  *
9010
9126
  * @param request - DeleteResourceControlRequest
9011
9127
  * @returns DeleteResourceControlResponse
@@ -9077,6 +9193,48 @@ export default class Client extends OpenApi {
9077
9193
  return await this.deleteSQLRateLimitingRulesWithOptions(request, runtime);
9078
9194
  }
9079
9195
 
9196
+ /**
9197
+ * Queries the API key of a model service.
9198
+ *
9199
+ * @param request - DescribeAIDBClusterApiKeysRequest
9200
+ * @param runtime - runtime options for this request RuntimeOptions
9201
+ * @returns DescribeAIDBClusterApiKeysResponse
9202
+ */
9203
+ async describeAIDBClusterApiKeysWithOptions(request: $_model.DescribeAIDBClusterApiKeysRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeAIDBClusterApiKeysResponse> {
9204
+ request.validate();
9205
+ let query = { };
9206
+ if (!$dara.isNull(request.regionId)) {
9207
+ query["RegionId"] = request.regionId;
9208
+ }
9209
+
9210
+ let req = new $OpenApiUtil.OpenApiRequest({
9211
+ query: OpenApiUtil.query(query),
9212
+ });
9213
+ let params = new $OpenApiUtil.Params({
9214
+ action: "DescribeAIDBClusterApiKeys",
9215
+ version: "2017-08-01",
9216
+ protocol: "HTTPS",
9217
+ pathname: "/",
9218
+ method: "POST",
9219
+ authType: "AK",
9220
+ style: "RPC",
9221
+ reqBodyType: "formData",
9222
+ bodyType: "json",
9223
+ });
9224
+ return $dara.cast<$_model.DescribeAIDBClusterApiKeysResponse>(await this.callApi(params, req, runtime), new $_model.DescribeAIDBClusterApiKeysResponse({}));
9225
+ }
9226
+
9227
+ /**
9228
+ * Queries the API key of a model service.
9229
+ *
9230
+ * @param request - DescribeAIDBClusterApiKeysRequest
9231
+ * @returns DescribeAIDBClusterApiKeysResponse
9232
+ */
9233
+ async describeAIDBClusterApiKeys(request: $_model.DescribeAIDBClusterApiKeysRequest): Promise<$_model.DescribeAIDBClusterApiKeysResponse> {
9234
+ let runtime = new $dara.RuntimeOptions({ });
9235
+ return await this.describeAIDBClusterApiKeysWithOptions(request, runtime);
9236
+ }
9237
+
9080
9238
  /**
9081
9239
  * Queries the details of a custom instance.
9082
9240
  *
@@ -27012,10 +27170,16 @@ export default class Client extends OpenApi {
27012
27170
  }
27013
27171
 
27014
27172
  /**
27015
- * Modifies resource control.
27173
+ * Modifies the CPU quota of an existing resource control rule in a specified PolarDB for MySQL cluster. You can modify the current quota value or switch between the maximum CPU percentage mode and the maximum CPU core count mode. You must specify one and only one of the MaxCpu and CpuCount parameters.
27016
27174
  *
27017
27175
  * @remarks
27018
- * > You can also modify the automatic backup policy of a PolarDB cluster in the console. For more information, see [Backup settings](https://help.aliyun.com/document_detail/280422.html).
27176
+ * Resource Control limits the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. It does not support querying Resource Control CPU usage.
27177
+ * ### Before you begin
27178
+ * - This operation applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
27179
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
27180
+ * - MaxCpu and CpuCount are two mutually exclusive CPU quota modes.
27181
+ * - The maximum value of CpuCount is determined by the cluster kernel parameter resource_control_cpu_count_limit.
27182
+ * >Notice: This is a notice.</notice>
27019
27183
  *
27020
27184
  * @param request - ModifyResourceControlRequest
27021
27185
  * @param runtime - runtime options for this request RuntimeOptions
@@ -27062,10 +27226,16 @@ export default class Client extends OpenApi {
27062
27226
  }
27063
27227
 
27064
27228
  /**
27065
- * Modifies resource control.
27229
+ * Modifies the CPU quota of an existing resource control rule in a specified PolarDB for MySQL cluster. You can modify the current quota value or switch between the maximum CPU percentage mode and the maximum CPU core count mode. You must specify one and only one of the MaxCpu and CpuCount parameters.
27066
27230
  *
27067
27231
  * @remarks
27068
- * > You can also modify the automatic backup policy of a PolarDB cluster in the console. For more information, see [Backup settings](https://help.aliyun.com/document_detail/280422.html).
27232
+ * Resource Control limits the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release supports creating, modifying, deleting, binding, and unbinding resource control rules. It does not support querying Resource Control CPU usage.
27233
+ * ### Before you begin
27234
+ * - This operation applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
27235
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
27236
+ * - MaxCpu and CpuCount are two mutually exclusive CPU quota modes.
27237
+ * - The maximum value of CpuCount is determined by the cluster kernel parameter resource_control_cpu_count_limit.
27238
+ * >Notice: This is a notice.</notice>
27069
27239
  *
27070
27240
  * @param request - ModifyResourceControlRequest
27071
27241
  * @returns ModifyResourceControlResponse
@@ -29374,11 +29544,14 @@ export default class Client extends OpenApi {
29374
29544
  }
29375
29545
 
29376
29546
  /**
29377
- * Unbinds a resource control.
29547
+ * Unbinds a specified resource control rule from a user, database, query, or connection in a PolarDB for MySQL cluster. After the unbinding is successful, the resource control rule no longer limits the CPU quota of the corresponding target object.
29378
29548
  *
29379
29549
  * @remarks
29380
- * > * Only the privileged user of a PolarDB for MySQL cluster can be reset.
29381
- * > * If the privileged user encounters issues, such as permissions being unexpectedly revoked (REVOKE), you can reset the permissions of the privileged user to restore it to normal.
29550
+ * Resource Control is used to limit the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release provides the capabilities to create, modify, delete, attach, and unbind resource control rules. It does not provide the capability to query Resource Control CPU usage.
29551
+ * ### Before you begin
29552
+ * - This operation applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
29553
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
29554
+ * >Notice: This is a notice.</notice>
29382
29555
  *
29383
29556
  * @param request - UnbindResourceControlRequest
29384
29557
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29425,11 +29598,14 @@ export default class Client extends OpenApi {
29425
29598
  }
29426
29599
 
29427
29600
  /**
29428
- * Unbinds a resource control.
29601
+ * Unbinds a specified resource control rule from a user, database, query, or connection in a PolarDB for MySQL cluster. After the unbinding is successful, the resource control rule no longer limits the CPU quota of the corresponding target object.
29429
29602
  *
29430
29603
  * @remarks
29431
- * > * Only the privileged user of a PolarDB for MySQL cluster can be reset.
29432
- * > * If the privileged user encounters issues, such as permissions being unexpectedly revoked (REVOKE), you can reset the permissions of the privileged user to restore it to normal.
29604
+ * Resource Control is used to limit the CPU resources that can be used by a specified user, database, query, or connection in a PolarDB for MySQL cluster. This release provides the capabilities to create, modify, delete, attach, and unbind resource control rules. It does not provide the capability to query Resource Control CPU usage.
29605
+ * ### Before you begin
29606
+ * - This operation applies only to PolarDB for MySQL Cluster Edition clusters that support Resource Control. PolarDB for MySQL Standard Edition is not supported.
29607
+ * - The cluster kernel parameter loose_enable_resource_control must be set to ON.
29608
+ * >Notice: This is a notice.</notice>
29433
29609
  *
29434
29610
  * @param request - UnbindResourceControlRequest
29435
29611
  * @returns UnbindResourceControlResponse
@@ -5,17 +5,17 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class BindResourceControlRequest extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * The cluster ID.
8
+ * The PolarDB cluster ID.
9
9
  *
10
10
  * This parameter is required.
11
11
  *
12
12
  * @example
13
- * pm-xxxxxx
13
+ * pc-**************
14
14
  */
15
15
  DBClusterId?: string;
16
16
  /**
17
17
  * @remarks
18
- * The region ID.
18
+ * The region ID of the PolarDB cluster.
19
19
  *
20
20
  * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/98041.html) operation to query available regions.
21
21
  *
@@ -25,32 +25,32 @@ export class BindResourceControlRequest extends $dara.Model {
25
25
  regionId?: string;
26
26
  /**
27
27
  * @remarks
28
- * The resource control name.
28
+ * The name of the resource control rule. The name must be 1 to 63 ASCII bytes in length, start with a letter, and can contain only letters, digits, and underscores.
29
29
  *
30
30
  * This parameter is required.
31
31
  *
32
32
  * @example
33
- * test-rc
33
+ * test_rc
34
34
  */
35
35
  resourceControlName?: string;
36
36
  /**
37
37
  * @remarks
38
- * The target instance type.
38
+ * The type of the binding target. Valid values: USER, DATABASE, QUERY, CONNECTION. The value is case-insensitive.
39
39
  *
40
40
  * This parameter is required.
41
41
  *
42
42
  * @example
43
- * 4
43
+ * USER
44
44
  */
45
45
  targetType?: string;
46
46
  /**
47
47
  * @remarks
48
- * The target value. This parameter applies to target tracking rules and prediction rules. The value of TargetValue can contain up to three decimal places and must be greater than 0.
48
+ * The value of the binding target. The format depends on the value of TargetType. For more information, see the table below.
49
49
  *
50
50
  * This parameter is required.
51
51
  *
52
52
  * @example
53
- * 646060ae9852280007a62545,68b696cb0a7fa600078d41af
53
+ * app_user
54
54
  */
55
55
  targetValue?: string;
56
56
  static names(): { [key: string]: string } {
@@ -0,0 +1,48 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class CreateAIDBClusterApiKeyRequest extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The description.
9
+ *
10
+ * @example
11
+ * test
12
+ */
13
+ description?: string;
14
+ /**
15
+ * @remarks
16
+ * The region ID.
17
+ * > * You can call the [DescribeRegions](https://help.aliyun.com/document_detail/98041.html) operation to query the regions of all clusters under the specified account.
18
+ * > * If you leave this parameter empty, scheduled tasks across all regions under the current account are queried.
19
+ *
20
+ * This parameter is required.
21
+ *
22
+ * @example
23
+ * cn-beijing
24
+ */
25
+ regionId?: string;
26
+ static names(): { [key: string]: string } {
27
+ return {
28
+ description: 'Description',
29
+ regionId: 'RegionId',
30
+ };
31
+ }
32
+
33
+ static types(): { [key: string]: any } {
34
+ return {
35
+ description: 'string',
36
+ regionId: 'string',
37
+ };
38
+ }
39
+
40
+ validate() {
41
+ super.validate();
42
+ }
43
+
44
+ constructor(map?: { [key: string]: any }) {
45
+ super(map);
46
+ }
47
+ }
48
+
@@ -0,0 +1,40 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+ import { CreateAIDBClusterApiKeyResponseBody } from "./CreateAidbclusterApiKeyResponseBody";
4
+
5
+
6
+ export class CreateAIDBClusterApiKeyResponse extends $dara.Model {
7
+ headers?: { [key: string]: string };
8
+ statusCode?: number;
9
+ body?: CreateAIDBClusterApiKeyResponseBody;
10
+ static names(): { [key: string]: string } {
11
+ return {
12
+ headers: 'headers',
13
+ statusCode: 'statusCode',
14
+ body: 'body',
15
+ };
16
+ }
17
+
18
+ static types(): { [key: string]: any } {
19
+ return {
20
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
21
+ statusCode: 'number',
22
+ body: CreateAIDBClusterApiKeyResponseBody,
23
+ };
24
+ }
25
+
26
+ validate() {
27
+ if(this.headers) {
28
+ $dara.Model.validateMap(this.headers);
29
+ }
30
+ if(this.body && typeof (this.body as any).validate === 'function') {
31
+ (this.body as any).validate();
32
+ }
33
+ super.validate();
34
+ }
35
+
36
+ constructor(map?: { [key: string]: any }) {
37
+ super(map);
38
+ }
39
+ }
40
+
@@ -0,0 +1,114 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class CreateAIDBClusterApiKeyResponseBodyApiKey extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The API key of the model service.
9
+ *
10
+ * @example
11
+ * xxx
12
+ */
13
+ apiKey?: string;
14
+ /**
15
+ * @remarks
16
+ * The creation time.
17
+ *
18
+ * @example
19
+ * 2026-06-12T03:41:53Z
20
+ */
21
+ createTime?: string;
22
+ /**
23
+ * @remarks
24
+ * The description.
25
+ *
26
+ * @example
27
+ * test
28
+ */
29
+ description?: string;
30
+ /**
31
+ * @remarks
32
+ * id
33
+ *
34
+ * @example
35
+ * 393
36
+ */
37
+ id?: string;
38
+ /**
39
+ * @remarks
40
+ * The API key status.
41
+ *
42
+ * @example
43
+ * active
44
+ */
45
+ status?: string;
46
+ static names(): { [key: string]: string } {
47
+ return {
48
+ apiKey: 'ApiKey',
49
+ createTime: 'CreateTime',
50
+ description: 'Description',
51
+ id: 'Id',
52
+ status: 'Status',
53
+ };
54
+ }
55
+
56
+ static types(): { [key: string]: any } {
57
+ return {
58
+ apiKey: 'string',
59
+ createTime: 'string',
60
+ description: 'string',
61
+ id: 'string',
62
+ status: 'string',
63
+ };
64
+ }
65
+
66
+ validate() {
67
+ super.validate();
68
+ }
69
+
70
+ constructor(map?: { [key: string]: any }) {
71
+ super(map);
72
+ }
73
+ }
74
+
75
+ export class CreateAIDBClusterApiKeyResponseBody extends $dara.Model {
76
+ /**
77
+ * @remarks
78
+ * The API key.
79
+ */
80
+ apiKey?: CreateAIDBClusterApiKeyResponseBodyApiKey;
81
+ /**
82
+ * @remarks
83
+ * Id of the request
84
+ *
85
+ * @example
86
+ * 2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
87
+ */
88
+ requestId?: string;
89
+ static names(): { [key: string]: string } {
90
+ return {
91
+ apiKey: 'ApiKey',
92
+ requestId: 'RequestId',
93
+ };
94
+ }
95
+
96
+ static types(): { [key: string]: any } {
97
+ return {
98
+ apiKey: CreateAIDBClusterApiKeyResponseBodyApiKey,
99
+ requestId: 'string',
100
+ };
101
+ }
102
+
103
+ validate() {
104
+ if(this.apiKey && typeof (this.apiKey as any).validate === 'function') {
105
+ (this.apiKey as any).validate();
106
+ }
107
+ super.validate();
108
+ }
109
+
110
+ constructor(map?: { [key: string]: any }) {
111
+ super(map);
112
+ }
113
+ }
114
+
@@ -5,15 +5,15 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class CreateResourceControlRequest extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * The total number of CPU cores.
8
+ * The maximum number of CPU cores that the resource control rule can use. The minimum value is 1. The maximum value is determined by the cluster kernel parameter resource_control_cpu_count_limit. You must specify one and only one of this parameter and MaxCpu.
9
9
  *
10
10
  * @example
11
- * 16
11
+ * 4
12
12
  */
13
13
  cpuCount?: number;
14
14
  /**
15
15
  * @remarks
16
- * The cluster ID.
16
+ * The PolarDB cluster ID.
17
17
  *
18
18
  * This parameter is required.
19
19
  *
@@ -23,15 +23,15 @@ export class CreateResourceControlRequest extends $dara.Model {
23
23
  DBClusterId?: string;
24
24
  /**
25
25
  * @remarks
26
- * The maximum number of CPUs. Unit: 0.001 CPU. A value of 1000 indicates one CPU. If you specify this parameter, instances whose CPU count is less than the specified value are returned.
26
+ * The maximum CPU quota percentage that the resource control rule can use. Valid values: 1 to 100. You must specify one and only one of this parameter and CpuCount.
27
27
  *
28
28
  * @example
29
- * 1000000
29
+ * 20
30
30
  */
31
31
  maxCpu?: number;
32
32
  /**
33
33
  * @remarks
34
- * The region ID.
34
+ * The region ID of the PolarDB cluster.
35
35
  * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/98041.html) operation to query available regions.
36
36
  *
37
37
  * @example
@@ -40,12 +40,12 @@ export class CreateResourceControlRequest extends $dara.Model {
40
40
  regionId?: string;
41
41
  /**
42
42
  * @remarks
43
- * The resource control name.
43
+ * The name of the resource control rule. The name must be 1 to 63 ASCII bytes in length, start with a letter, and can contain only letters, digits, and underscores.
44
44
  *
45
45
  * This parameter is required.
46
46
  *
47
47
  * @example
48
- * test-rc
48
+ * test_rc
49
49
  */
50
50
  resourceControlName?: string;
51
51
  static names(): { [key: string]: string } {