@alicloud/polardb20170801 8.4.2 → 9.0.0

package/src/models/CheckAccountNameZonalRequest.ts

@@ -17,6 +17,8 @@ export class CheckAccountNameZonalRequest extends $dara.Model {
    * @remarks
    * The cluster ID.
    * 
+   * > Note: This parameter accepts only edge cluster IDs, which you can obtain by calling the DescribeDBClustersZonal operation. For common PolarDB clusters, use the CheckAccountName operation.
+   * 
    * This parameter is required.
    * 
    * @example

package/src/models/CheckDbnameZonalRequest.ts

@@ -5,7 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class CheckDBNameZonalRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the cluster.
+   * The cluster ID.
+   * 
+   * > Note: This parameter accepts only edge cluster IDs obtained by calling DescribeDBClustersZonal. Regular PolarDB cluster IDs obtained by calling DescribeDBClusters are not supported.
    * 
    * This parameter is required.
    * 
@@ -15,7 +17,7 @@ export class CheckDBNameZonalRequest extends $dara.Model {
   DBClusterId?: string;
   /**
    * @remarks
-   * The name of the database.
+   * The database name.
    * 
    * This parameter is required.
    * 

package/src/models/CheckDbnameZonalResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CheckDBNameZonalResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The name of the database.
+   * The database name.
    * 
    * @example
    * test_db
@@ -13,7 +13,7 @@ export class CheckDBNameZonalResponseBody extends $dara.Model {
   DBName?: string;
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * CDB3258F-B5DE-43C4-8935-CBA0CA******

package/src/models/CreateAccountZonalRequest.ts

@@ -7,9 +7,9 @@ export class CreateAccountZonalRequest extends $dara.Model {
    * @remarks
    * The description of the account. The description must meet the following requirements:
    * 
-   * - Cannot start with `http://` or `https://`.
+   * - It cannot start with `http://` or `https://`.
    * 
-   * - Be 2 to 256 characters in length.
+   * - It must be 2 to 256 characters in length.
    * 
    * @example
    * testdes
@@ -17,15 +17,15 @@ export class CreateAccountZonalRequest extends $dara.Model {
   accountDescription?: string;
   /**
    * @remarks
-   * The account name. The name must meet the following requirements:
+   * The name of the account. The name must meet the following requirements:
    * 
-   * - Start with a lowercase letter and end with a letter or a digit.
+   * - It must start with a lowercase letter and end with a letter or a digit.
    * 
-   * - Contain only lowercase letters, digits, and underscores (_).
+   * - It can contain lowercase letters, digits, and underscores (_).
    * 
-   * - Be 2 to 16 characters in length.
+   * - It must be 2 to 16 characters in length.
    * 
-   * - Cannot be a reserved username, such as root or admin.
+   * - It cannot be a reserved username, such as root or admin.
    * 
    * This parameter is required.
    * 
@@ -35,13 +35,13 @@ export class CreateAccountZonalRequest extends $dara.Model {
   accountName?: string;
   /**
    * @remarks
-   * The account password. The password must meet the following requirements:
+   * The password of the account. The password must meet the following requirements:
    * 
-   * - Contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
+   * - It must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
    * 
-   * - Be 8 to 32 characters in length.
+   * - It must be 8 to 32 characters in length.
    * 
-   * - Special characters are `!@#$%^&*()_+-=`.
+   * - Special characters include `!@#$%^&*()_+-=`.
    * 
    * This parameter is required.
    * 
@@ -53,15 +53,15 @@ export class CreateAccountZonalRequest extends $dara.Model {
    * @remarks
    * The permissions of the account. Valid values:
    * 
-   * - ReadWrite: read and write permissions.
+   * - ReadWrite: read and write permissions
    * 
-   * - ReadOnly: read-only permissions.
+   * - ReadOnly: read-only permissions
    * 
-   * - DMLOnly: DML permissions only.
+   * - DMLOnly: DML-only permissions
    * 
-   * - DDLOnly: DDL permissions only.
+   * - DDLOnly: DDL-only permissions
    * 
-   * - ReadIndex: read and index permissions.
+   * - ReadIndex: read and index permissions
    * 
    * @example
    * ReadWrite
@@ -69,11 +69,11 @@ export class CreateAccountZonalRequest extends $dara.Model {
   accountPrivilege?: string;
   /**
    * @remarks
-   * The account type. Valid values:
+   * The type of the account. Valid values:
    * 
-   * - Normal: a standard account.
+   * - Normal: standard account
    * 
-   * - Super: a privileged account.
+   * - Super: privileged account
    * 
    * @example
    * Normal
@@ -81,7 +81,7 @@ export class CreateAccountZonalRequest extends $dara.Model {
   accountType?: string;
   /**
    * @remarks
-   * A client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token is case-sensitive and can contain a maximum of 64 ASCII characters.
+   * The client token that is used to ensure the idempotence of the request and prevent duplicate submissions. You can generate the value of this parameter on the client side. The value must be unique across different requests and is case-sensitive. It can contain a maximum of 64 ASCII characters.
    * 
    * @example
    * 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
@@ -91,6 +91,8 @@ export class CreateAccountZonalRequest extends $dara.Model {
    * @remarks
    * The cluster ID.
    * 
+   * > Note: Only edge cluster (Zonal) IDs are supported. You can query them by calling the DescribeDBClustersZonal operation. Standard PolarDB cluster IDs returned by DescribeDBClusters cannot be used for this API operation.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -99,7 +101,7 @@ export class CreateAccountZonalRequest extends $dara.Model {
   DBClusterId?: string;
   /**
    * @remarks
-   * The name of the database that the destination account can access. You can specify multiple database names. Separate them with commas (,).
+   * The names of the databases that the account is authorized to access. You can specify multiple database names separated by commas (,).
    * 
    * @example
    * testdb
@@ -117,11 +119,11 @@ export class CreateAccountZonalRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * Specifies whether to grant permissions on all current and future databases in the cluster. Valid values:
+   * Specifies whether to grant the account permissions on all existing databases and all databases to be created in the cluster. Valid values:
    * 
-   * - 0 or empty: Does not grant permissions.
+   * - 0 or empty: no
    * 
-   * - 1: Grants permissions.
+   * - 1: yes
    * 
    * @example
    * 0

package/src/models/CreateAgenticDbprojectResponseBody.ts

@@ -15,6 +15,8 @@ export class CreateAgenticDBProjectResponseBody extends $dara.Model {
    * @remarks
    * The time when the project was created.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2026-06-10T11:00:00Z
    */

package/src/models/CreateAgenticDbtenantApiKeyRequest.ts

@@ -41,7 +41,7 @@ export class CreateAgenticDBTenantApiKeyRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The tenant name. The name must be unique within the cluster and contain 2 to 64 characters.
+   * The tenant name. The name must be unique within the cluster and must be 2 to 64 characters in length.
    * 
    * This parameter is required.
    * 

package/src/models/CreateAgenticDbtenantApiKeyResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAgenticDBTenantApiKeyResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The plaintext of the API key. This value is returned only in this response.
+   * The API key in plaintext. This value is returned only in this response.
    * 
    * @example
    * pagc_key_xxxx.yyyy
@@ -23,6 +23,8 @@ export class CreateAgenticDBTenantApiKeyResponseBody extends $dara.Model {
    * @remarks
    * The time when the API key was created.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2026-06-10T08:00:00Z
    */
@@ -31,6 +33,8 @@ export class CreateAgenticDBTenantApiKeyResponseBody extends $dara.Model {
    * @remarks
    * The expiration time of the API key. This value is empty if the API key never expires.
    * 
+   * The time is in ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
+   * 
    * @example
    * 2027-01-01T00:00:00Z
    */

package/src/models/CreateAidbclusterApiKeyRequest.ts

@@ -23,7 +23,7 @@ export class CreateAIDBClusterApiKeyRequest extends $dara.Model {
    * @remarks
    * The region ID.
    * > * You can call the [DescribeRegions](https://help.aliyun.com/document_detail/98041.html) operation to query the region information of all clusters under the specified account.
-   * > * If this parameter is left empty, scheduled tasks in all regions under the current account are queried by default.
+   * > * If you leave this parameter empty, scheduled tasks across all regions under the current account are queried.
    * 
    * This parameter is required.
    * 

package/src/models/CreateAidbclusterApiKeyResponseBody.ts

@@ -13,7 +13,9 @@ export class CreateAIDBClusterApiKeyResponseBodyApiKey extends $dara.Model {
   apiKey?: string;
   /**
    * @remarks
-   * The creation time.
+   * The time when the API key was created.
+   * 
+   * The time is in the ISO 8601 format in UTC (format: YYYY-MM-DDTHH:mm:ssZ).
    * 
    * @example
    * 2026-06-12T03:41:53Z

package/src/models/CreateAidbclusterRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAIDBClusterRequestTimeSlices extends $dara.Model {
   /**
    * @remarks
-   * The start time of the task. The time is in the `YYYY-MM-DDThh:mm:ssZ` format (UTC).
+   * The start time of the task. Specify the time in the `YYYY-MM-DDThh:mm:ssZ` format. The time must be in UTC.
    * 
    * @example
    * 1758729600
@@ -13,7 +13,7 @@ export class CreateAIDBClusterRequestTimeSlices extends $dara.Model {
   beginTime?: number;
   /**
    * @remarks
-   * The end time of the query. The end time must be later than the start time. The time is in the `YYYY-MM-DDThh:mmZ` format (UTC).
+   * The end time of the query. The end time must be later than the start time. Specify the time in the `YYYY-MM-DDThh:mmZ` format. The time must be in UTC.
    * 
    * @example
    * 1758733200
@@ -55,12 +55,12 @@ export class CreateAIDBClusterRequest extends $dara.Model {
    * @remarks
    * Specifies whether to enable auto-renewal. Valid values:
    * 
-   * - **true**: Auto-renewal is enabled.
-   * - **false**: Auto-renewal is not enabled.
+   * - **true**: enables auto-renewal.
+   * - **false**: disables auto-renewal.
    * 
    * Default value: **false**.
    * 
-   * > This parameter takes effect only when **PayType** is set to **Prepaid**.
+   * > This parameter takes effect only when the **PayType** parameter is set to **Prepaid**.
    * 
    * @example
    * false
@@ -69,13 +69,21 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   /**
    * @remarks
    * Specifies whether to automatically use coupons. Valid values:
-   * * true (default): Use coupons.
-   * * false: Do not use coupons.
+   * * true (default): uses coupons.
+   * * false: does not use coupons.
    * 
    * @example
    * false
    */
   autoUseCoupon?: boolean;
+  /**
+   * @remarks
+   * The initial model capacity of the instance. The value must be a positive integer. A capacity unit of 1000 is equivalent to one L20N equivalent card.
+   * 
+   * @example
+   * 4000
+   */
+  capacity?: number;
   clientToken?: string;
   /**
    * @remarks
@@ -87,7 +95,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   createPublicEndpoint?: string;
   /**
    * @remarks
-   * The cluster description. Fuzzy match is supported.
+   * The description of the cluster. Fuzzy match is supported.
    * 
    * @example
    * test
@@ -95,7 +103,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   DBClusterDescription?: string;
   /**
    * @remarks
-   * The instance ID of the PolarDB instance on which the application depends.
+   * The PolarDB instance ID on which the application depends.
    * 
    * @example
    * pc-******************
@@ -127,7 +135,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   inferenceEngine?: string;
   /**
    * @remarks
-   * The ACK cluster ID.
+   * The ID of the ACK cluster.
    * 
    * @example
    * xxxxxxxxxxxxxxxxxxxxxxx
@@ -143,7 +151,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   kubeConfig?: string;
   /**
    * @remarks
-   * The Kubernetes cluster management mode.
+   * The management mode of the Kubernetes cluster.
    * 
    * @example
    * self_k8s
@@ -175,7 +183,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   managementMode?: string;
   /**
    * @remarks
-   * The model name.
+   * The name of the model.
    * 
    * @example
    * Qwen3-30B-A3B
@@ -214,10 +222,10 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   payType?: string;
   /**
    * @remarks
-   * This parameter is required to pass parameter when **PayType** is set to **Prepaid**. Specifies the unit of the upfront payment duration for the subscription cluster. 
+   * If the billing method is **Prepaid**, you must pass parameter. Specifies the upfront cluster as yearly or monthly. Valid values: 
    * 
-   * - **Year**: The subscription duration is measured in years.
-   * - **Month**: The subscription duration is measured in months.
+   * - **Year**: yearly. The unit is year.
+   * - **Month**: monthly. The unit is month.
    * 
    * @example
    * 5
@@ -225,7 +233,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   period?: string;
   /**
    * @remarks
-   * The coupon code. If this parameter is not specified, the default coupon is used.
+   * The coupon code. If you do not specify this parameter, the default coupon is used.
    * 
    * @example
    * 727xxxxxx934
@@ -245,7 +253,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The security group ID.
+   * The ID of the security group.
    * 
    * @example
    * sg-bp**************
@@ -269,14 +277,14 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   storageType?: string;
   /**
    * @remarks
-   * The pay-as-you-go time intervals.
+   * The pay-as-you-go time ranges.
    */
   timeSlices?: CreateAIDBClusterRequestTimeSlices[];
   /**
    * @remarks
-   * This parameter is required when **PayType** is set to **Prepaid**.
-   * - If **Period** is set to **Month**, the valid values of **UsedTime** are integers in the range of `[1-9]`.
-   * - If **Period** is set to **Year**, the valid values of **UsedTime** are integers in the range of `[1-3]`.
+   * The subscription duration. This parameter is required when the billing method is set to **Prepaid**.
+   * - If **Period** is set to **Month**, the value of **UsedTime** is an integer ranging from `1` to `9`.
+   * - If **Period** is set to **Year**, the value of **UsedTime** is an integer ranging from `1` to `3`.
    * 
    * @example
    * 1
@@ -284,7 +292,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   usedTime?: string;
   /**
    * @remarks
-   * The VPC ID.
+   * The ID of the virtual private cloud (VPC).
    * 
    * This parameter is required.
    * 
@@ -294,7 +302,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
   VPCId?: string;
   /**
    * @remarks
-   * The vSwitch ID.
+   * The ID of the vSwitch.
    * 
    * This parameter is required.
    * 
@@ -315,6 +323,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
       ackAdmin: 'AckAdmin',
       autoRenew: 'AutoRenew',
       autoUseCoupon: 'AutoUseCoupon',
+      capacity: 'Capacity',
       clientToken: 'ClientToken',
       createPublicEndpoint: 'CreatePublicEndpoint',
       DBClusterDescription: 'DBClusterDescription',
@@ -355,6 +364,7 @@ export class CreateAIDBClusterRequest extends $dara.Model {
       ackAdmin: 'string',
       autoRenew: 'string',
       autoUseCoupon: 'boolean',
+      capacity: 'number',
       clientToken: 'string',
       createPublicEndpoint: 'string',
       DBClusterDescription: 'string',

package/src/models/CreateAidbclusterResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAIDBClusterResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The cluster ID.
+   * The ID of the cluster.
    * 
    * @example
    * pc-******************
@@ -13,7 +13,7 @@ export class CreateAIDBClusterResponseBody extends $dara.Model {
   DBClusterId?: string;
   /**
    * @remarks
-   * The order ID.
+   * The ID of the order.
    * 
    * @example
    * 2035638*******
@@ -29,7 +29,7 @@ export class CreateAIDBClusterResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The resource group ID.
+   * The ID of the resource group.
    * 
    * @example
    * rg-************

package/src/models/CreateAidbclusterTaskRequest.ts

@@ -33,7 +33,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   dataserviceMode?: string;
   /**
    * @remarks
-   * The training dataset ID. This parameter is required for fine-tuning.
+   * The ID of the training dataset. This parameter is required for fine-tuning.
    * 
    * @example
    * pds-2zetrain***
@@ -41,7 +41,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   datasetPath?: string;
   /**
    * @remarks
-   * The validation dataset ID. This parameter is required for evaluation.
+   * The ID of the validation dataset. This parameter is required for evaluation.
    * 
    * @example
    * pds-2zetrain***
@@ -49,8 +49,8 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   evalDatasetPath?: string;
   /**
    * @remarks
-   * The model service type. Valid values:
-   *  * **aitrain**: model operator tuning
+   * The type of the model service. Valid values:
+   *  * **aitrain**: Model operator tuning.
    * 
    * This parameter is required.
    * 
@@ -60,9 +60,9 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   kubeType?: string;
   /**
    * @remarks
-   * The model name.
-   * * **For a preset model, specify the name of the selected model.**
-   * * **For a custom model, specify the path where the model is stored (the model trained in a cold storage instance).**
+   * The name of the model.
+   * * **For a preset model, specify the selected model name.**
+   * * **For a custom model, specify the path of the model (the trained model in a cold storage instance).**
    * 
    * This parameter is required.
    * 
@@ -72,9 +72,9 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   modelName?: string;
   /**
    * @remarks
-   * The model source. Valid values:
-   * * **public**: preset model
-   * * **custom**: custom model
+   * The source of the model. Valid values:
+   * * **public**: Preset model.
+   * * **custom**: Custom model.
    * 
    * This parameter is required.
    * 
@@ -84,7 +84,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   modelSource?: string;
   /**
    * @remarks
-   * The custom model type.
+   * The type of the custom model.
    * 
    * @example
    * qwen3
@@ -104,7 +104,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The running parameters in a JSON string.
+   * The runtime parameters. The value is a JSON string.
    * 
    * This parameter is required.
    * 
@@ -122,7 +122,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   securityGroupId?: string;
   /**
    * @remarks
-   * The model service description.
+   * The description of the model service.
    * 
    * @example
    * xxxx
@@ -131,7 +131,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   tuneArch?: string;
   /**
    * @remarks
-   * The virtual private cloud (VPC) ID.
+   * The VPC ID.
    * 
    * @example
    * vpc-*******************
@@ -139,7 +139,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   VPCId?: string;
   /**
    * @remarks
-   * The vSwitch ID.
+   * The ID of the vSwitch.
    * 
    * @example
    * vsw-*********************