@alicloud/polardb20170801 7.3.0 → 7.5.0

package/src/models/CreateAccountRequest.ts

@@ -7,9 +7,8 @@ export class CreateAccountRequest extends $dara.Model {
    * @remarks
    * The description of the account. The description must meet the following requirements:
    * 
-   * - It cannot start with `http://` or `https://`.
-   * 
-   * - It must be 2 to 256 characters in length.
+   * - Cannot start with `http://` or `https://`.
+   * - Is 2 to 256 characters in length.
    * 
    * @example
    * testdes
@@ -17,15 +16,12 @@ export class CreateAccountRequest extends $dara.Model {
   accountDescription?: string;
   /**
    * @remarks
-   * The name of the database account. The name must meet the following requirements:
-   * 
-   * - It must start with a lowercase letter and end with a letter or a digit.
-   * 
-   * - It can contain lowercase letters, digits, and underscores (_).
+   * The account name. The name must meet the following requirements:
    * 
-   * - It must be 2 to 16 characters in length.
-   * 
-   * - It cannot be a reserved keyword, such as root or admin.
+   * * Starts with a lowercase letter and ends with a letter or digit.
+   * * Contains only lowercase letters, digits, or underscores (_).
+   * * Is 2 to 16 characters in length.
+   * * Cannot use certain reserved usernames such as root or admin.
    * 
    * This parameter is required.
    * 
@@ -35,13 +31,10 @@ export class CreateAccountRequest extends $dara.Model {
   accountName?: string;
   /**
    * @remarks
-   * The password of the database account. The password must meet the following requirements:
-   * 
-   * - It must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
-   * 
-   * - It must be 8 to 32 characters in length.
-   * 
-   * - The special characters are `!@#$%^&*()_+-=`.
+   * The account password. The password must meet the following requirements:
+   * * Contains at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
+   * * Is 8 to 32 characters in length.
+   * * Special characters include `!@#$%^&*()_+-=`.
    * 
    * This parameter is required.
    * 
@@ -51,23 +44,17 @@ export class CreateAccountRequest extends $dara.Model {
   accountPassword?: string;
   /**
    * @remarks
-   * The privilege level to grant on the specified databases. Valid values:
-   * 
-   * - **ReadWrite**: read and write permissions
-   * 
-   * - **ReadOnly**: read-only permissions
+   * The permissions of the account. Valid values: 
    * 
-   * - **DMLOnly**: DML permissions only
+   * * **ReadWrite**: read and write
+   * * **ReadOnly**: read-only
+   * * **DMLOnly**: DML only
+   * * **DDLOnly**: DDL only
+   * * **ReadIndex**: read-only and index
    * 
-   * - **DDLOnly**: DDL permissions only
-   * 
-   * - **ReadIndex**: read-only and index permissions
-   * 
-   * > * This parameter takes effect only when you specify the `DBName` parameter.
-   * >
-   * > * If you specify multiple databases in `DBName`, you must specify a corresponding permission for each in `AccountPrivilege`, separated by commas. The `AccountPrivilege` string cannot exceed 900 characters. For example, to grant read and write permissions to database DB1 and read-only permissions to database DB2, set `DBName` to `DB1,DB2` and set `AccountPrivilege` to `ReadWrite,ReadOnly`.
-   * >
-   * > * This parameter applies only to standard accounts on PolarDB for MySQL clusters.
+   * >* The DBName parameter must be specified for AccountPrivilege to take effect.
+   * >* If you specify multiple database names for the DBName parameter, you must grant the corresponding permissions to each database. Separate multiple permissions with commas (,) and make sure that the total length of the AccountPrivilege string does not exceed 900 characters. For example, to grant read and write permissions on database DB1 and read-only permissions on database DB2, set DBName to `DB1,DB2` and set AccountPrivilege to `ReadWrite,ReadOnly`.
+   * > * This parameter is supported only for standard accounts of PolarDB for MySQL clusters.
    * 
    * @example
    * ReadWrite
@@ -75,17 +62,18 @@ export class CreateAccountRequest extends $dara.Model {
   accountPrivilege?: string;
   /**
    * @remarks
-   * The type of the account. Valid values:
+   * The account type. Valid values:
    * 
-   * - **Normal**: a standard account.
+   * - **Normal**: standard account. 
+   * - **Super**: privileged account. 
+   * - **DynamoDB**: DynamoDB account. 
    * 
-   * - **Super**: a privileged account.
    * 
-   * > * If you do not specify this parameter, the system creates a **Super** account by default.
-   * >
-   * > * You can create multiple privileged accounts on PolarDB for PostgreSQL (Oracle-Compatible) and PolarDB for PostgreSQL clusters. A privileged account has more permissions than a standard account. For more information, see [Create database accounts](https://help.aliyun.com/document_detail/68508.html).
-   * >
-   * > * For a PolarDB for MySQL cluster, you can create only one privileged account. For more information, see [Create database accounts](https://help.aliyun.com/document_detail/68508.html).
+   *  
+   * > * If this parameter is left empty, a **Super** account is created by default.
+   * > * If the cluster is a PolarDB for PostgreSQL (Compatible with Oracle) or PolarDB for PostgreSQL cluster, you can create multiple privileged accounts for each cluster. Privileged accounts have more permissions than standard accounts. For more information, see [Create a database account](https://help.aliyun.com/document_detail/68508.html).
+   * > * If the cluster is a PolarDB for MySQL cluster, you can create at most one privileged account for each cluster. Privileged accounts have more permissions than standard accounts. For more information, see [Create a database account](https://help.aliyun.com/document_detail/68508.html).
+   * > * DynamoDB accounts are dedicated accounts created for the DynamoDB compatibility feature of PolarDB for PostgreSQL. For more information, see [DynamoDB usage instructions](https://help.aliyun.com/document_detail/2979941.html).
    * 
    * @example
    * Normal
@@ -93,7 +81,7 @@ export class CreateAccountRequest extends $dara.Model {
   accountType?: string;
   /**
    * @remarks
-   * A client-generated token to ensure request idempotency. The token must be unique across requests. It is case-sensitive and can be up to 64 ASCII characters long.
+   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the value. Make sure that the value is unique among different requests. The token is case-sensitive and cannot exceed 64 ASCII characters in length.
    * 
    * @example
    * 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
@@ -111,9 +99,9 @@ export class CreateAccountRequest extends $dara.Model {
   DBClusterId?: string;
   /**
    * @remarks
-   * The name of the database that the account can access. To specify multiple databases, separate the database names with a comma (,).
+   * The name of the database that the account is authorized to access. You can specify multiple database names separated by commas (,).
    * 
-   * > This parameter applies only to standard accounts on PolarDB for MySQL clusters.
+   * > This parameter is supported only for standard accounts of PolarDB for MySQL clusters.
    * 
    * @example
    * testdb
@@ -121,9 +109,9 @@ export class CreateAccountRequest extends $dara.Model {
   DBName?: string;
   /**
    * @remarks
-   * The type of the node. Valid values:
+   * The node type. Valid values:
    * 
-   * - **Search**: For creating an account on a PolarDB Search node.
+   * - Search: required when creating an account for a PolarDB Search node
    * 
    * @example
    * Search
@@ -133,15 +121,13 @@ export class CreateAccountRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * Specifies whether to grant the account permissions on all current and future databases in the cluster. Valid values:
-   * 
-   * - **0 or do not specify**: The specified permissions are not granted to all databases.
+   * Specifies whether to grant permissions on all existing databases and all new databases in the current cluster. Valid values:
    * 
-   * - **1**: Grants the specified permissions to all current and future databases.
+   * - **0 or empty**: does not grant permissions.
    * 
-   * > * This parameter takes effect only when you specify the `AccountPrivilege` parameter.
-   * >
-   * > * If you set this parameter to `1`, the permissions specified in `AccountPrivilege` are granted to all databases.
+   * - **1**: grants permissions.
+   * >* The AccountPrivilege parameter must be specified for this parameter to take effect.
+   * >* If this parameter is set to `1`, the permissions specified by AccountPrivilege are granted on all databases.
    * 
    * @example
    * 0

package/src/models/CreateAidbclusterTaskRequest.ts

@@ -23,7 +23,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   DBInstanceClass?: string;
   /**
    * @remarks
-   * The ID of the training dataset. This parameter is required for fine-tuning.
+   * The training dataset ID. This parameter is required for fine-tuning.
    * 
    * @example
    * pds-2zetrain***
@@ -31,7 +31,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   datasetPath?: string;
   /**
    * @remarks
-   * The ID of the validation dataset. This parameter is required for evaluation.
+   * The validation dataset ID. This parameter is required for evaluation.
    * 
    * @example
    * pds-2zetrain***
@@ -39,9 +39,8 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   evalDatasetPath?: string;
   /**
    * @remarks
-   * The type of model service. Valid values:
-   * 
-   * - **aitrain**: For model operator tuning.
+   * The model service type. Valid values:
+   *  * **aitrain**: model operator tuning
    * 
    * This parameter is required.
    * 
@@ -52,10 +51,8 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   /**
    * @remarks
    * The model name.
-   * 
-   * - For a **preset model**, specify the model name.
-   * 
-   * - For a **custom model**, specify the path to the model. This option is for models trained in a cold storage edition instance.
+   * * **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).**
    * 
    * This parameter is required.
    * 
@@ -66,10 +63,8 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   /**
    * @remarks
    * The model source. Valid values:
-   * 
-   * - **public**: A preset model.
-   * 
-   * - **custom**: A custom model.
+   * * **public**: preset model
+   * * **custom**: custom model
    * 
    * This parameter is required.
    * 
@@ -79,7 +74,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   modelSource?: string;
   /**
    * @remarks
-   * The type of the custom model.
+   * The custom model type.
    * 
    * @example
    * qwen3
@@ -99,7 +94,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The runtime parameters, specified as a JSON string.
+   * The running parameters in JSON string format.
    * 
    * This parameter is required.
    * 
@@ -117,15 +112,16 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
   securityGroupId?: string;
   /**
    * @remarks
-   * The name of the task.
+   * The description of the model service.
    * 
    * @example
    * xxxx
    */
   taskName?: string;
+  tuneArch?: string;
   /**
    * @remarks
-   * The VPC ID.
+   * The virtual private cloud (VPC) ID.
    * 
    * @example
    * vpc-*******************
@@ -165,6 +161,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
       runningParameter: 'RunningParameter',
       securityGroupId: 'SecurityGroupId',
       taskName: 'TaskName',
+      tuneArch: 'TuneArch',
       VPCId: 'VPCId',
       vSwitchId: 'VSwitchId',
       zoneId: 'ZoneId',
@@ -189,6 +186,7 @@ export class CreateAIDBClusterTaskRequest extends $dara.Model {
       runningParameter: 'string',
       securityGroupId: 'string',
       taskName: 'string',
+      tuneArch: 'string',
       VPCId: 'string',
       vSwitchId: 'string',
       zoneId: 'string',

package/src/models/CreateAidbclusterTaskResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAIDBClusterTaskResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the model operator instance.
+   * The instance ID of the generated model service.
    * 
    * @example
    * pm-2zo88***
@@ -21,7 +21,7 @@ export class CreateAIDBClusterTaskResponseBody extends $dara.Model {
   orderId?: string;
   /**
    * @remarks
-   * The request ID.
+   * Id of the request
    * 
    * @example
    * CED079B7-A408-41A1-BFF1-EC608E******

package/src/models/CreateBackupRequest.ts

@@ -5,12 +5,13 @@ import * as $dara from '@darabonba/typescript';
 export class CreateBackupRequest extends $dara.Model {
   /**
    * @remarks
-   * A client token to ensure the idempotence of the request. The client generates this value, which must be unique among different requests. The token is case-sensitive and cannot exceed 64 ASCII characters.
+   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that the token is unique among different requests. The token is case-sensitive and can contain only ASCII characters. The token can be up to 64 characters in length.
    * 
    * @example
    * 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
    */
   clientToken?: string;
+  comment?: string;
   /**
    * @remarks
    * The cluster ID.
@@ -28,6 +29,7 @@ export class CreateBackupRequest extends $dara.Model {
   static names(): { [key: string]: string } {
     return {
       clientToken: 'ClientToken',
+      comment: 'Comment',
       DBClusterId: 'DBClusterId',
       ownerAccount: 'OwnerAccount',
       ownerId: 'OwnerId',
@@ -39,6 +41,7 @@ export class CreateBackupRequest extends $dara.Model {
   static types(): { [key: string]: any } {
     return {
       clientToken: 'string',
+      comment: 'string',
       DBClusterId: 'string',
       ownerAccount: 'string',
       ownerId: 'number',

package/src/models/CreateBackupResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateBackupResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The backup job ID.
+   * The backup set ID.
    * 
    * @example
    * 11111111

package/src/models/CreateDbclusterEndpointRequest.ts

@@ -5,11 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class CreateDBClusterEndpointRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to automatically add new nodes to the endpoint. Valid values:
-   * 
-   * - **Enable**: Automatically adds new nodes to the endpoint.
-   * 
-   * - **Disable** (default): Does not automatically add new nodes to the endpoint.
+   * Specifies whether new nodes are automatically added to this endpoint. Valid values:
+   * * **Enable**: New nodes are automatically added to this endpoint.
+   * * **Disable** (default): New nodes are not automatically added to this endpoint.
    * 
    * @example
    * Disable
@@ -17,7 +15,7 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   autoAddNewNodes?: string;
   /**
    * @remarks
-   * A client-generated token to ensure the idempotence of the request. The token must be unique, case-sensitive, and a maximum of 64 ASCII characters.
+   * The client token that is used to ensure the idempotence of the request and prevent repeated submissions. The token is generated by the client, must be unique across requests, is case-sensitive, and cannot exceed 64 ASCII characters in length.
    * 
    * @example
    * 6000170000591aed949d0f******************
@@ -43,73 +41,41 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   DBEndpointDescription?: string;
   /**
    * @remarks
-   * The advanced configurations for the custom cluster endpoint, specified as a JSON string. You can configure features such as consistency level, transaction splitting, whether the primary node accepts read requests, connection pool, and load balancing policy.
-   * 
-   * - Specifies the load balancing policy. The format is {"LoadBalancePolicy":"policy"}. Valid values:
-   * 
-   *   - **0**: connections-based load balancing (default).
-   * 
-   *   - **1**: active requests-based load balancing.
-   * 
-   * - Specifies the consistency level. The format is `{"ConsistLevel":"level"}`. Valid values:
-   * 
-   *   - **0**: eventual consistency.
-   * 
-   *   - **1**: session consistency (default).
-   * 
-   *   - **2**: global consistency.
-   * 
-   * - Specifies whether to enable transaction splitting. The format is `{"DistributedTransaction":"status"}`. Valid values:
-   * 
-   *   - **on**: enables transaction splitting (default).
-   * 
-   *   - **off**: disables transaction splitting.
-   * 
-   * - Specifies whether the primary node accepts read requests. The format is `{"MasterAcceptReads":"status"}`. Valid values:
-   * 
-   *   - **on**: The primary node accepts read requests.
-   * 
-   *   - **off**: The primary node does not accept read requests (default).
-   * 
-   * - Specifies whether to enable the connection pool. The format is `{"ConnectionPersist":"status"}`. Valid values:
-   * 
-   *   - **off**: disables the connection pool (default).
-   * 
-   *   - **Session**: enables the session-level connection pool.
-   * 
-   *   - **Transaction**: enables the transaction-level connection pool.
-   * 
-   * - Specifies the degree of parallelism for a parallel query. The format is {"MaxParallelDegree":"degree"}. Valid values:
-   * 
-   *   - A specific integer that specifies the degree of parallelism. For example: "MaxParallelDegree":"2".
-   * 
-   *   - **off**: disables parallel query (default).
-   * 
-   * - Specifies whether to enable automatic routing between row store and column store. The format is {"EnableHtapImci":"status"}. Valid values:
-   * 
-   *   - **on**: enables automatic routing.
-   * 
-   *   - **off**: disables automatic routing (default).
-   * 
-   * - Specifies whether to enable overload protection. The format is {"EnableOverloadThrottle":"status"}. Valid values:
-   * 
-   *   - **on**: enables overload protection.
-   * 
-   *   - **off**: disables overload protection (default).
-   * 
-   * > * You can configure transaction splitting, whether the primary node accepts read requests, the connection pool, and overload protection only for a PolarDB for MySQL endpoint in **ReadWrite** (automatic read/write splitting) mode.
-   * >
-   * > * A PolarDB for MySQL cluster endpoint in **ReadOnly** mode supports both **connections-based load balancing** and **active requests-based load balancing**. An endpoint in **ReadWrite** (automatic read/write splitting) mode supports only **active requests-based load balancing**.
-   * >
-   * > * You can enable automatic routing between row store and column store if the read/write mode of the cluster endpoint for PolarDB for MySQL is **ReadWrite** (automatic read/write splitting), or if the read/write mode is **ReadOnly** and the load balancing policy is **active requests-based load balancing**.
-   * >
-   * > * Only PolarDB for MySQL clusters support global consistency.
-   * >
-   * > * If you set **ReadWriteMode** to **ReadOnly**, the consistency level must be **0** (eventual consistency).
-   * >
-   * > * You can configure the consistency level, transaction splitting, whether the primary node accepts read requests, and the connection pool at the same time. Example: `{"ConsistLevel":"1","DistributedTransaction":"on","ConnectionPersist":"Session","MasterAcceptReads":"on"}`.
-   * >
-   * > * The setting for transaction splitting depends on the consistency level. For example, if you set the consistency level to **0** (eventual consistency), you cannot enable transaction splitting. If you set the consistency level to **1** (session consistency) or **2** (global consistency), you can enable transaction splitting.
+   * The advanced configurations of the cluster endpoint in JSON format. You can configure the consistency level, transaction splitting, offload reads from primary node, and connection pool settings.
+   * * Load balancing policy. Format: {\\"LoadBalancePolicy\\":\\"Load balancing policy\\"}. Valid values:
+   *    * **0**: connection-based load balancing (default).
+   *    * **1**: active-request-based load balancing.
+   * * Consistency level. Format: `{"ConsistLevel":"Consistency level"}`. Valid values:
+   *     * **0**: eventual consistency.
+   *     * **1**: session consistency (default).
+   *     * **2**: global consistency.
+   * * Transaction splitting. Format: `{"DistributedTransaction":"Transaction splitting"}`. Valid values:
+   *     * **on**: enables transaction splitting (default).
+   *     * **off**: disables transaction splitting.
+   * * Offload reads from primary node. Format: `{"MasterAcceptReads":"Offload reads from primary node"}`. Valid values:
+   *     * **on**: the primary node accepts read requests.
+   *     * **off**: the primary node does not accept read requests (default).
+   * * Connection pool. Format: `{"ConnectionPersist":"Connection pool"}`. Valid values:
+   *     * **off**: disables the connection pool (default).
+   *     * **Session**: enables session-level connection pooling.
+   *     * **Transaction**: enables transaction-level connection pooling.
+   * * Parallel query. Format: {\\"MaxParallelDegree\\":\\"Parallel query\\"}. Valid values:
+   *     * A specific degree of parallelism. Example: "MaxParallelDegree":"2".
+   *     * **off**: disables parallel query (default).
+   * * Automatic request distribution among row store and column store nodes. Format: {\\"EnableHtapImci\\":\\"Automatic request distribution among row store and column store nodes\\"}. Valid values:
+   *     * **on**: enables automatic request distribution among row store and column store nodes.
+   *     * **off**: disables automatic request distribution among row store and column store nodes (default).
+   * * Overload protection. Format: {\\"EnableOverloadThrottle\\":\\"Overload protection\\"}. Valid values:
+   *    * **on**: enables overload protection.
+   *    * **off**: disables overload protection (default).
+   * 
+   * > * Transaction splitting, offload reads from primary node, connection pool, and overload protection can be configured only when the read/write mode of the PolarDB for MySQL cluster endpoint is **ReadWrite (automatic read/write splitting)**.
+   * >* When the read/write mode of the PolarDB for MySQL cluster endpoint is **ReadOnly**, both **connection-based load balancing** and **active-request-based load balancing** are supported. The **ReadWrite (automatic read/write splitting)** mode supports only **active-request-based load balancing**.
+   * >* Automatic request distribution among row store and column store nodes can be configured when the read/write mode of the PolarDB for MySQL cluster endpoint is **ReadWrite (automatic read/write splitting)**, or when the read/write mode is **ReadOnly** and the load balancing policy is **active-request-based load balancing**.
+   * >* Only PolarDB for MySQL supports setting the consistency level to global consistency.
+   * >* If **ReadWriteMode** is set to **ReadOnly**, the consistency level can only be set to **0**.
+   * >* You can configure the consistency level, transaction splitting, offload reads from primary node, and connection pool at the same time. Example: `{"ConsistLevel":"1","DistributedTransaction":"on","ConnectionPersist":"Session","MasterAcceptReads":"on"}`.
+   * >* Transaction splitting is constrained by the consistency level. For example, transaction splitting cannot be enabled when the consistency level is **0**. Transaction splitting can be enabled when the consistency level is **1** or **2**.
    * 
    * @example
    * {"ConsistLevel": "1","DistributedTransaction": "on"}
@@ -117,7 +83,11 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   endpointConfig?: string;
   /**
    * @remarks
-   * The type of the custom cluster endpoint. Set the value to **Custom**.
+   * The type of the custom cluster endpoint. Valid values:
+   * 
+   * - **Custom**: custom cluster endpoint.
+   * 
+   * - **DynamoDB**: DynamoDB endpoint.
    * 
    * This parameter is required.
    * 
@@ -127,17 +97,14 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   endpointType?: string;
   /**
    * @remarks
-   * The nodes to associate with the endpoint. Separate multiple node IDs with a comma (,). If you omit this parameter, all nodes in the cluster are added by default.
+   * The read load nodes to add to the endpoint. Separate multiple nodes with commas (,). By default, all nodes are added. 
    * 
-   * > - For a PolarDB for MySQL cluster, specify the node IDs.
-   * >
-   * > - For a PolarDB for PostgreSQL cluster or a PolarDB for PostgreSQL (compatible with Oracle) cluster, specify the roles of the nodes, such as `Writer,Reader1,Reader2`.
-   * >
-   * > - If you set **ReadWriteMode** to **ReadOnly**, you can associate only one node with the endpoint. If this node fails, the endpoint may be unavailable for up to 1 hour. This configuration is not recommended for a production environment. To improve availability, associate at least two nodes with the endpoint.
-   * >
-   * > - If you set **ReadWriteMode** to **ReadWrite**, you must associate at least two nodes with the endpoint.
-   * >   \\* For a PolarDB for MySQL cluster, you can select any two nodes. If both nodes are read-only nodes, write requests are routed to the primary node.
-   * >   \\* For a PolarDB for PostgreSQL cluster or a PolarDB for PostgreSQL (compatible with Oracle) cluster, the primary node must be included.
+   * > * For PolarDB for MySQL, specify node IDs.
+   * >* For PolarDB for PostgreSQL and PolarDB for PostgreSQL (Compatible with Oracle), specify node role names, such as `Writer,Reader1,Reader2`.
+   * >* If **ReadWriteMode** is set to **ReadOnly**, you can mount only one node. However, if this node fails, the endpoint may be unavailable for up to 1 hour. Do not use this configuration in production environments. Select at least 2 nodes to improve availability.
+   * >* If **ReadWriteMode** is set to **ReadWrite**, select at least 2 nodes.
+   *     * For PolarDB for MySQL, you can select any two nodes. If both nodes are read-only nodes, write requests are forwarded to the primary node.
+   *     * For PolarDB for PostgreSQL and PolarDB for PostgreSQL (Compatible with Oracle), the primary node must be included.
    * 
    * @example
    * pi-**********,pi-*********
@@ -146,17 +113,20 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   ownerAccount?: string;
   ownerId?: number;
   /**
+   * @remarks
+   * The PolarFs instance ID.
+   * 
    * @example
    * pfs-test****
    */
   polarFsInstanceId?: string;
   /**
    * @remarks
-   * The policy for handling global consistency read timeouts. Valid values:
+   * The timeout policy for global consistency. Valid values:
    * 
-   * - **0**: Send the request to the primary node.
+   * - **0**: sends the request to the primary node.
    * 
-   * - **2**: Downgrade to a regular request. If a global consistency read times out, the query is automatically downgraded, and the client does not receive an error.
+   * - **2**: timeout degradation. After a global consistency read times out, the query is automatically degraded to regular requests, and the client does not receive an error message.
    * 
    * @example
    * 0
@@ -172,10 +142,9 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   polarSccWaitTimeout?: string;
   /**
    * @remarks
-   * The read/write mode. Valid values:
-   * 
-   * - **ReadWrite**: read/write (automatic read/write splitting).
+   * The read/write mode. Valid values: 
    * 
+   * - **ReadWrite**: read/write (automatic read/write splitting). 
    * - **ReadOnly** (default): read-only.
    * 
    * @example
@@ -186,22 +155,28 @@ export class CreateDBClusterEndpointRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * Specifies whether to enable global consistency (high-performance mode). Valid values:
+   * Specifies whether to enable the global consistency (high-performance mode) feature for the node. Valid values:
    * 
-   * - **ON**: Enables the feature.
+   * - **ON**: enabled.
    * 
-   * - **OFF**: Disables the feature.
+   * - **OFF**: disabled.
    * 
    * @example
    * on
    */
   sccMode?: string;
   /**
+   * @remarks
+   * The VPC ID.
+   * 
    * @example
    * vpc-2zehr7ghqovftils0****
    */
   VPCId?: string;
   /**
+   * @remarks
+   * The vSwitch ID.
+   * 
    * @example
    * vsw-2ze775gnf7jn33ua****
    */

package/src/models/DescribeAgenticDbcomputeClustersRequest.ts

@@ -10,6 +10,8 @@ export class DescribeAgenticDBComputeClustersRequest extends $dara.Model {
   computeClusterId?: string;
   /**
    * @remarks
+   * The AgenticDB cluster ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -17,17 +19,25 @@ export class DescribeAgenticDBComputeClustersRequest extends $dara.Model {
    */
   DBClusterId?: string;
   /**
+   * @remarks
+   * The page number. Default value: 1.
+   * 
    * @example
    * 1
    */
   pageNumber?: number;
   /**
+   * @remarks
+   * The number of entries per page. Default value: 30. Maximum value: 100.
+   * 
    * @example
    * 30
    */
   pageSize?: number;
   /**
    * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -35,6 +45,9 @@ export class DescribeAgenticDBComputeClustersRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The status filter. Valid values: Running, Stopped, and Waiting.
+   * 
    * @example
    * Running
    */