@alicloud/rds20140815 16.0.0 → 16.1.0

package/src/models/UpdateUserBackupFileRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateUserBackupFileRequest extends $dara.Model {
   /**
    * @remarks
-   * The user backup ID. You can call ListUserBackupFiles to obtain the ID.
+   * The ID of the user backup. You can call the ListUserBackupFiles operation to query the ID.
    * 
    * This parameter is required.
    * 
@@ -15,7 +15,7 @@ export class UpdateUserBackupFileRequest extends $dara.Model {
   backupId?: string;
   /**
    * @remarks
-   * The new description to set for the user backup.
+   * The new description of the user backup.
    * 
    * @example
    * CommentTest
@@ -24,7 +24,7 @@ export class UpdateUserBackupFileRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The region ID. You can call DescribeRegions to obtain the ID.
+   * The region ID. You can call the DescribeRegions operation to query the region ID.
    * 
    * This parameter is required.
    * 
@@ -34,7 +34,7 @@ export class UpdateUserBackupFileRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The resource group ID. You can call the DescribeDBInstanceAttribute operation to obtain the ID.
+   * The ID of the resource group. You can call the DescribeDBInstanceAttribute operation to query the ID.
    * 
    * @example
    * rg-acfmy****

package/src/models/UpdateUserBackupFileResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateUserBackupFileResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The user backup ID.
+   * The ID of the user backup.
    * 
    * @example
    * b-lvn2365ev9f1****
@@ -13,7 +13,7 @@ export class UpdateUserBackupFileResponseBody extends $dara.Model {
   backupId?: string;
   /**
    * @remarks
-   * The request ID.
+   * The ID of the request.
    * 
    * @example
    * 29EBB093-DBD8-5EEB-841D-E611B88CDE4B

package/src/models/UpgradeDbinstanceKernelVersionRequest.ts

@@ -5,10 +5,10 @@ import * as $dara from '@darabonba/typescript';
 export class UpgradeDBInstanceKernelVersionRequest extends $dara.Model {
   /**
    * @remarks
-   * The instance ID. You can invoke DescribeDBInstances to query the instance ID.
+   * The ID of the instance. You can call the DescribeDBInstances operation to query the instance ID.
    * 
-   * > * The storage type of the ApsaraDB RDS for PostgreSQL instance must be **cloud disks**. For an instance with Premium Local SSDs, you can invoke the [RestartDBInstance](https://help.aliyun.com/document_detail/26230.html) operation to restart the instance, which automatically upgrades the instance to the latest minor engine version.
-   * > * Only the 2019 version of ApsaraDB RDS for SQL Server supports minor engine version upgrades.
+   * > * The storage type of the ApsaraDB RDS for PostgreSQL instance must be **cloud disk**. You can call the [restart the instance](https://help.aliyun.com/document_detail/26230.html) operation to restart an instance with Premium Local SSDs to automatically upgrade the instance to the latest minor engine version.
+   * > * Only ApsaraDB RDS for SQL Server 2019 instances support minor engine version upgrades.
    * 
    * This parameter is required.
    * 
@@ -21,8 +21,8 @@ export class UpgradeDBInstanceKernelVersionRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The specified time. Format: <i>yyyy-MM-dd</i>T<i>HH:mm:ss</i>Z (UTC).
-   * > This parameter takes effect only when **UpgradeTime** is set to **SpecifyTime**.
+   * The specified time when the upgrade is performed. Specify the time in the <i>yyyy-MM-dd</i>T<i>HH:mm:ss</i>Z format. The time must be in UTC.
+   * >This parameter takes effect only when **UpgradeTime** is set to **SpecifyTime**.
    * 
    * @example
    * 2020-01-15T00:00:00Z
@@ -30,16 +30,16 @@ export class UpgradeDBInstanceKernelVersionRequest extends $dara.Model {
   switchTime?: string;
   /**
    * @remarks
-   * The minor database engine version to which you want to upgrade. Format:
-   * * **PostgreSQL**: `rds_postgres_<Major version number>00_<Minor version number>`. Example for version 12 with minor version 20200830: `rds_postgres_1200_20200830`.
-   * * **MySQL**: `<Instance version>_<Minor version number>`. Examples: `rds_20200229`, `xcluster_20200229`, or `xcluster80_20200229`. The instance version can be one of the following:
-   *     * **rds**: high-availability series or Basic Edition.
+   * The target minor database version. Format:
+   * * **PostgreSQL**: `rds_postgres_<Major version number>00_<Minor version number>`. Example: `rds_postgres_1200_20200830` for PostgreSQL 12 version 20200830.
+   * * **MySQL**: `<Instance edition>_<Minor version number>`. Examples: `rds_20200229`, `xcluster_20200229`, and `xcluster80_20200229`. The instance editions are as follows:
+   *     * **rds**: high availability series or Basic Edition.
    *     * **xcluster**: MySQL 5.7 RDS Enterprise Edition.
    *     * **xcluster80**: MySQL 8.0 RDS Enterprise Edition.
-   * * **SQLServer**: `<Minor version number>`. Example: `15.0.4073.23`.
+   * * **SQL Server**: `<Minor version number>`. Example: `15.0.4073.23`.
    * 
-   * If you do not specify this parameter, the instance is upgraded to the latest minor engine version by default.
-   * > For minor engine version numbers, see [Release notes of ApsaraDB RDS for PostgreSQL minor engine versions](https://help.aliyun.com/document_detail/126002.html), [Release notes of ApsaraDB RDS for MySQL minor engine versions](https://help.aliyun.com/document_detail/96060.html), and [Release notes of ApsaraDB RDS for SQL Server minor engine versions](https://help.aliyun.com/document_detail/213577.html).
+   * If you do not specify this parameter, the instance is upgraded to the latest minor database version by default.
+   * > For more information about minor database versions, see [Release notes for minor engine versions of ApsaraDB RDS for PostgreSQL](https://help.aliyun.com/document_detail/126002.html), [Release notes for minor engine versions of ApsaraDB RDS for MySQL](https://help.aliyun.com/document_detail/96060.html), and [Release notes for minor engine versions of ApsaraDB RDS for SQL Server](https://help.aliyun.com/document_detail/213577.html).
    * 
    * @example
    * xcluster80_20210305
@@ -47,11 +47,11 @@ export class UpgradeDBInstanceKernelVersionRequest extends $dara.Model {
   targetMinorVersion?: string;
   /**
    * @remarks
-   * The upgrade time. Valid values:
+   * The time when the upgrade is performed. Valid values:
    * 
-   * * **Immediate** (default): The upgrade takes effect immediately.
-   * * **MaintainTime**: The upgrade takes effect during the maintenance window. To modify the maintenance window, call ModifyDBInstanceMaintainTime.
-   * * **SpecifyTime**: The upgrade takes effect at a specified time.
+   * * **Immediate**: The upgrade is immediately performed. This is the default value.
+   * * **MaintainTime**: The upgrade is performed within the specified maintenance window. For more information about how to modify the maintenance window, see ModifyDBInstanceMaintainTime.
+   * * **SpecifyTime**: The upgrade is performed at the specified time.
    * 
    * @example
    * Immediate

package/src/models/UpgradeDbinstanceKernelVersionResponseBody.ts

@@ -13,7 +13,7 @@ export class UpgradeDBInstanceKernelVersionResponseBody extends $dara.Model {
   DBInstanceName?: string;
   /**
    * @remarks
-   * The request ID.
+   * The ID of the request.
    * 
    * @example
    * DA2ECBA0-4745-4491-9166-799FF8984AC9
@@ -21,7 +21,7 @@ export class UpgradeDBInstanceKernelVersionResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The target minor engine version to which the instance is upgraded.
+   * The target minor engine version.
    * 
    * @example
    * xcluster80_20210305
@@ -29,7 +29,7 @@ export class UpgradeDBInstanceKernelVersionResponseBody extends $dara.Model {
   targetMinorVersion?: string;
   /**
    * @remarks
-   * The task ID.
+   * The ID of the task.
    * 
    * @example
    * 226917711

package/src/models/UpgradeDbinstanceMajorVersionRequest.ts

@@ -6,24 +6,32 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   allowDDL?: boolean;
   /**
    * @remarks
-   * Specifies when to execute statistics information collection on the database.
-   * - **Before**: Execute collection before the switchover. This ensures business stability. If the instance has a large data volume, the upgrade may take a long time.
-   * - **After**: Execute collection after the switchover. The upgrade is faster. Accessing tables without generated statistics information after the upgrade may cause inaccurate execution plans. During peak hours, this may cause the database to break down.
+   * Specifies when to execute statistics collection for the database.
+   * Valid values:
+   * - **Before**: collects statistics before the cutover. This ensures business stability. If the data volume of the instance is too large, the upgrade may take a long time.
+   * - **After**: collects statistics after the cutover. This accelerates the instance upgrade. Accessing tables for which no statistics are generated after the upgrade may lead to inaccurate execution plans and even database breakdown during peak hours.
    * 
-   * > For non-switchover scenarios, "before switchover" means statistics information is collected before the new instance is opened for read/write, and "after switchover" means statistics information is collected after the new instance is opened for read/write.
+   * > For scenarios where no cutover is performed, collecting statistics before the cutover means collecting statistics before the new instance enables read and write operations, and collecting statistics after the cutover means collecting statistics after the new instance enables read and write operations.
    * 
    * @example
    * After
    */
   collectStatMode?: string;
+  /**
+   * @remarks
+   * An internal reserved field. You do not need to specify this parameter.
+   * 
+   * @example
+   * An internal reserved field. You do not need to specify this parameter
+   */
   customExtraInfo?: string;
   /**
    * @remarks
-   * The instance type after the upgrade. The CPU and memory configurations must be greater than or equal to those of the original instance type. If **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
+   * The instance type after the upgrade. The CPU and memory configurations must be greater than or equal to those of the original instance. When **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
    * 
-   * For example, if the original instance type is `pg.n2.small.2c` with 1 CPU core and 2 GB of memory, you can upgrade it to `pg.n2.medium.2c` with 2 CPU cores and 4 GB of memory.
+   * For example, if the original instance type is `pg.n2.small.2c` with 1 core and 2 GB of memory, you can upgrade it to `pg.n2.medium.2c` with 2 cores and 4 GB of memory.
    * 
-   * > For the instance type codes of ApsaraDB RDS for PostgreSQL, refer to [Primary ApsaraDB RDS for PostgreSQL instance types](https://help.aliyun.com/document_detail/276990.html).
+   * > For more information about ApsaraDB RDS for PostgreSQL instance types, see [Primary ApsaraDB RDS for PostgreSQL instance types](https://help.aliyun.com/document_detail/276990.html).
    * 
    * @example
    * pg.n2.medium.2c
@@ -31,7 +39,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   DBInstanceClass?: string;
   /**
    * @remarks
-   * The instance ID of the original instance.
+   * The ID of the original instance.
    * 
    * @example
    * pgm-bp1gm3yh0ht1****
@@ -39,15 +47,15 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   DBInstanceId?: string;
   /**
    * @remarks
-   * The instance storage capacity after the upgrade. Unit: GB. If **UpgradeMode** (upgrade pattern) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
+   * The instance storage after the upgrade. Unit: GB. When **UpgradeMode** (upgrade mode) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
    * 
    * Valid values:
-   * - **PL1 ESSD cloud disk**: 20 GB to 3200 GB
-   * - **PL2 ESSD cloud disk**: 500 GB to 3200 GB
-   * - **PL3 ESSD cloud disk**: 1500 GB to 3200 GB
-   * - **Premium performance disk**: 40 GB to 2000 GB
+   * - **ESSD PL1 cloud disk**: 20 GB to 3,200 GB
+   * - **ESSD PL2 cloud disk**: 500 GB to 3,200 GB
+   * - **ESSD PL3 cloud disk**: 1,500 GB to 3,200 GB
+   * - **premium cloud disk**: 40 GB to 2,000 GB
    * 
-   * > When upgrading the major engine version of an instance with Premium Local SSDs, storage capacity reduction is supported. For the minimum storage capacity, refer to [Upgrade the major engine version of a database](https://help.aliyun.com/document_detail/203309.html).
+   * > When you upgrade the major database version of an instance with premium local SSDs, storage capacity reduction is supported. For more information about the minimum storage capacity, see [Upgrade the major engine version](https://help.aliyun.com/document_detail/203309.html).
    * 
    * @example
    * 20
@@ -58,17 +66,16 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
    * The storage type of the instance after the upgrade.
    * 
    * Valid values:
-   * - **cloud_ssd**: standard SSD
-   * - **cloud_essd**: PL1 ESSD
-   * - **cloud_essd2**: PL2 ESSD
-   * - **cloud_essd3**: PL3 ESSD
-   * - **general_essd**: premium performance disk
+   * - **cloud_ssd**: standard SSD cloud disk
+   * - **cloud_essd**: ESSD PL1 cloud disk
+   * - **cloud_essd2**: ESSD PL2 cloud disk
+   * - **cloud_essd3**: ESSD PL3 cloud disk
+   * - **general_essd**: premium cloud disk
    * 
-   * 
-   * The major engine version upgrade feature is based on cloud disk snapshots. The supported storage types after the upgrade are as follows:
-   * - If the original instance uses a standard SSD, you can select standard SSD.
-   * - If the original instance uses an ESSD cloud disk, you can select PL1 ESSD, PL2 ESSD, PL3 ESSD, or premium performance disk.
-   * - If the original instance uses Premium Local SSDs, you can select PL1 ESSD, PL2 ESSD, PL3 ESSD, or premium performance disk.
+   * The major engine version upgrade feature is based on cloud disk snapshots. The following storage types are supported after the upgrade:
+   * - When the original instance uses standard SSD cloud disks, you can select standard SSD cloud disks.
+   * - When the original instance uses ESSD cloud disks, you can select ESSD PL1 cloud disks, ESSD PL2 cloud disks, ESSD PL3 cloud disks, or premium cloud disks.
+   * - When the original instance uses premium local SSDs, you can select ESSD PL1 cloud disks, ESSD PL2 cloud disks, ESSD PL3 cloud disks, or premium cloud disks.
    * 
    * @example
    * cloud_essd
@@ -76,9 +83,9 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   DBInstanceStorageType?: string;
   /**
    * @remarks
-   * The network type of the instance after the upgrade. Set this parameter to VPC. Only VPC-connected instances support major engine version upgrades.
+   * The network type of the instance after the upgrade. Set the value to VPC. Only VPC-connected instances support major engine version upgrades.
    * 
-   * If the network type is classic network, switch to VPC first. For information about how to view or switch the network type, refer to [Switch the network type](https://help.aliyun.com/document_detail/96761.html).
+   * If the instance is connected to the classic network, switch the network type to VPC first. For more information about how to view or switch the network type, see [Switch the network type](https://help.aliyun.com/document_detail/96761.html).
    * 
    * @example
    * VPC
@@ -86,9 +93,9 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   instanceNetworkType?: string;
   /**
    * @remarks
-   * The billing method of the instance. Set this parameter to Postpaid for pay-as-you-go billing.
+   * The billing method. Set the value to Postpaid, which indicates the pay-as-you-go billing method.
    * 
-   * > If you want to change the billing method after the upgrade, refer to [Switch from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/96743.html).
+   * > If you want to change the billing method of the instance after the upgrade, see [Switch the billing method from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/96743.html).
    * 
    * This parameter is required.
    * 
@@ -98,7 +105,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   payType?: string;
   /**
    * @remarks
-   * Reserved parameter. You do not need to configure this parameter.
+   * A reserved parameter. You do not need to configure this parameter.
    * 
    * @example
    * Month
@@ -106,7 +113,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   period?: string;
   /**
    * @remarks
-   * You do not need to configure this parameter. It specifies the internal IP address of the target instance. The system automatically assigns an IP address based on VPCId and vSwitchId by default.
+   * You do not need to configure this parameter. It specifies the internal IP address of the target instance. By default, the system automatically allocates an IP address based on the VPCId and vSwitchId parameters.
    * 
    * @example
    * 172.16.XX.XX
@@ -115,20 +122,19 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The switchover configuration. Specifies whether to switch traffic to the new version instance based on your business requirements.
+   * The cutover configuration. Specifies whether to switch traffic to the new-version instance based on your business requirements.
    * 
    * Valid values:
+   * - **true**: performs the cutover and automatic switchover. This option is generally used to execute a formal upgrade after you confirm that your business can run stably on the new version.
+   * - **false**: does not perform the cutover and does not perform automatic switchover. This option is generally used to test the compatibility of your current business with the new version before a formal upgrade.
    * 
-   * - **true**: Switchover is performed and automatic switchover is enabled. This option is typically used to execute the formal upgrade after confirming that your business can run stably on the new version.
-   * - **false**: Switchover is not performed and automatic switchover is not enabled. This option is typically used to test the compatibility of your application with the new version before the formal upgrade.
-   * 
-   * > - If you select switchover:
-   * >     - Switchover cannot be rolled back after execution. Proceed with caution.
-   * >     - During the switchover procedure, the original instance becomes read-only and writes are not allowed. Execute the switchover during off-peak hours.
-   * >     - If read-only instances are created for the original instance, you cannot select switchover. You can only upgrade the instance without switchover, and the original read-only instances are not cloned. After the upgrade, create new PostgreSQL read-only instances for the new version instance.
-   * > - If you do not select switchover:
-   * >     - The business on the original instance is not affected during migration.
-   * >     - To upgrade the instance without switchover, change the database connection address in your application to the database connection address of the new instance after migration is complete. For information about how to view the connection address, refer to [View or modify the internal and public endpoints and port numbers](https://help.aliyun.com/document_detail/96788.html).
+   * > - If you choose to perform the cutover:
+   * >     - Backoff is not supported after the cutover. Proceed with caution.
+   * >     - During the switchover procedure, the original instance becomes read-only and your business cannot write data to the instance. Make sure that you execute the cutover during off-peak hours.
+   * >     - If read-only instances are attached to the original instance, you cannot perform the cutover. You can only upgrade the instance without performing the cutover, and the original read-only instances are not cloned. After the upgrade is complete, you must create PostgreSQL read-only instances for the new-version instance.
+   * > - If you choose not to perform the cutover:
+   * >     - Your business on the original instance is not affected during the migration.
+   * >     - If you upgrade the instance without performing the cutover, you must change the database endpoint in your application to the endpoint of the new instance after the migration is complete. For more information about how to view the endpoint, see [View or change the internal and public endpoints and port numbers](https://help.aliyun.com/document_detail/96788.html).
    * 
    * @example
    * false
@@ -136,7 +142,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   switchOver?: string;
   /**
    * @remarks
-   * Reserved parameter. You do not need to configure this parameter.
+   * A reserved parameter. You do not need to configure this parameter.
    * 
    * @example
    * 2021-07-10T13:15:12Z
@@ -144,11 +150,11 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   switchTime?: string;
   /**
    * @remarks
-   * This parameter is used together with SwitchOver and takes effect only when **SwitchOver** is set to **true**. Specifies the switchover time.
+   * The cutover time. This parameter is used together with SwitchOver and takes effect only when **SwitchOver** is set to **true**.
    * 
    * Valid values:
-   * - **Immediate**: The switchover takes effect immediately.
-   * - **MaintainTime**: The switchover takes effect during the maintenance window. You can call the ModifyDBInstanceMaintainTime operation to modify the maintenance window.
+   * - **Immediate**: The cutover takes effect immediately.
+   * - **MaintainTime**: The cutover takes effect within the maintenance window. You can call the ModifyDBInstanceMaintainTime operation to modify the maintenance window.
    * 
    * @example
    * Immediate
@@ -156,9 +162,9 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   switchTimeMode?: string;
   /**
    * @remarks
-   * The target major engine version of the instance after the upgrade. This value must be the same as the target version specified during the pre-upgrade check.
+   * The target major engine version after the upgrade. The value must be the same as the target version specified when you perform the pre-upgrade check.
    * 
-   * > You can call the UpgradeDBInstanceMajorVersionPrecheck operation to perform a pre-upgrade check for the major engine version upgrade.
+   * > You can call the UpgradeDBInstanceMajorVersionPrecheck operation to perform a pre-upgrade check for a major engine version upgrade.
    * 
    * @example
    * 13.0
@@ -166,11 +172,11 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   targetMajorVersion?: string;
   /**
    * @remarks
-   * The upgrade pattern. Configure this parameter when **SwitchOver** is set to **true**. Valid values:
+   * The upgrade mode. When **SwitchOver** is set to **true**, you must configure this parameter. Valid values:
    * 
-   * - **inPlaceUpgrade**: In-place upgrade. The major engine version upgrade task is executed on the original instance without creating a new version instance. After the upgrade, the original instance inherits the existing order, instance name, tags, CloudMonitor alert rules, and backup rules.
-   * - **blueGreenDeployment**: Blue-green deployment. The major engine version upgrade retains the original instance and creates a new version instance. The new instance is free of charge during creation. After the new instance is created, fees are incurred and the billing method may change. After the upgrade, both the original and new instances incur fees, and the new instance does not inherit the discounts of the original instance.
-   * - **zeroDownTimeUpgrade**: Zero-downtime upgrade. The system uses pg_upgrade to upgrade the original instance to the target version and uses native logical replication for incremental updates. Active switchover is supported during the upgrade procedure, and you can validate the higher version instance before the switchover. From the start of the upgrade until the active switchover, the instance maintains normal read/write operations. During the switchover, the read-only duration is at the second level.
+   * - **inPlaceUpgrade**: in-place upgrade. The major engine version upgrade task is executed on the original instance, and no new-version instance is created. The major engine version of the original instance is upgraded, and the original instance inherits the existing orders, instance name, tags, CloudMonitor alert rules, and backup rules.
+   * - **blueGreenDeployment**: blue-green deployment. The major engine version upgrade retains the original instance and creates a new-version instance. You are not charged for the new instance while it is being created, but you are charged after it is created, and the billing method may change. After the upgrade is complete, both the original instance and the new instance incur fees, and the new instance does not enjoy the discounts of the original instance.
+   * - **zeroDownTimeUpgrade**: zero-downtime upgrade. The system uses pg_upgrade to upgrade the original instance to the target version and implements incremental updates through native logical replication. Manual switchover is supported during the upgrade procedure, and you can verify the higher-version instance before the switchover. From the start of the upgrade to the manual switchover, the instance can maintain normal read and write operations. During the switchover, the read-only duration of the instance is measured in seconds.
    * 
    * @example
    * inPlaceUpgrade
@@ -178,7 +184,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   upgradeMode?: string;
   /**
    * @remarks
-   * Reserved parameter. You do not need to configure this parameter.
+   * A reserved parameter. You do not need to configure this parameter.
    * 
    * @example
    * 1
@@ -186,9 +192,9 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   usedTime?: string;
   /**
    * @remarks
-   * The VPC ID. If **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
+   * The VPC ID. When **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
    * 
-   * You can call the DescribeDBInstanceAttribute operation to query the VPC ID of the original instance.
+   * You can call the DescribeDBInstanceAttribute operation to view the VPC ID of the original instance.
    * 
    * @example
    * vpc-bp1opxu1zkhn00gzv****
@@ -196,11 +202,11 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   VPCId?: string;
   /**
    * @remarks
-   * The vSwitch ID of the target instance. If **UpgradeMode** (upgrade pattern) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
-   * - If the original instance is a Basic Edition instance, specify the vSwitch ID of the target instance.
-   * - If the original instance is a high-availability series instance, you can specify the vSwitch IDs of the target primary and secondary instances, separated by commas (,).
+   * The vSwitch ID of the target instance. When **UpgradeMode** (upgrade mode) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
+   * - When the original instance is a Basic Edition instance, configure the vSwitch ID of the target instance.
+   * - When the original instance is a high availability instance, you can configure the vSwitch IDs of the target primary and secondary instances, separated by commas (,).
    * 
-   * > The target vSwitch must be in the same zone as the original instance. You can call the DescribeVSwitches operation to query vSwitches.
+   * > The configured vSwitch of the target instance must be in the same zone as the original instance. You can call the DescribeVSwitches operation to query the vSwitch ID.
    * 
    * @example
    * vsw-bp10aqj6o4lclxdrm****,vsw-bp10aqj6o4lclxdrm****
@@ -208,11 +214,11 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   vSwitchId?: string;
   /**
    * @remarks
-   * The primary zone ID of the target instance. If **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
+   * The ID of the destination primary zone. When **UpgradeMode** is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
    * 
-   * You can call the DescribeRegions operation to query zone IDs.
+   * You can call the DescribeRegions operation to view the zone ID.
    * 
-   * ApsaraDB RDS for PostgreSQL allows you to deploy the new instance in a different zone within the same region as the original instance after the upgrade.
+   * ApsaraDB RDS for PostgreSQL allows you to configure the new instance in a different zone within the same region as the original instance after the upgrade.
    * 
    * @example
    * cn-hangzhou-j
@@ -220,11 +226,11 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   zoneId?: string;
   /**
    * @remarks
-   * This parameter can be configured only when the original instance is a high-availability series instance. Specifies the secondary zone ID of the target instance. If **UpgradeMode** (upgrade pattern) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, **you do not need to configure** this parameter.
+   * The ID of the secondary zone of the target instance. This parameter is available only when the original instance is a high availability instance. When **UpgradeMode** (upgrade mode) is set to **inPlaceUpgrade** or **zeroDownTimeUpgrade**, you **do not need to configure** this parameter.
    * 
-   * ApsaraDB RDS for PostgreSQL allows you to deploy the new secondary instance in a different zone within the same region as the original instance after the upgrade.
+   * ApsaraDB RDS for PostgreSQL allows you to configure the new secondary instance in a different zone within the same region as the original instance after the upgrade.
    * 
-   * You can call the DescribeRegions operation to query zone IDs.
+   * You can call the DescribeRegions operation to view the zone ID.
    * 
    * @example
    * cn-hangzhou-j
@@ -232,7 +238,7 @@ export class UpgradeDBInstanceMajorVersionRequest extends $dara.Model {
   zoneIdSlave1?: string;
   /**
    * @remarks
-   * Reserved parameter. You do not need to configure this parameter.
+   * A reserved parameter. You do not need to configure this parameter.
    * 
    * @example
    * cn-hangzhou-j

package/src/models/UpgradeDbinstanceMajorVersionResponseBody.ts

@@ -29,7 +29,7 @@ export class UpgradeDBInstanceMajorVersionResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Reserved parameter.
+   * A reserved parameter.
    * 
    * @example
    * 416980000

package/src/models/UpgradeDbproxyInstanceKernelVersionRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpgradeDBProxyInstanceKernelVersionRequest extends $dara.Model {
   /**
    * @remarks
-   * The instance ID. You can call DescribeDBInstances to query the instance ID.
+   * Instance ID of the instance. You can call the DescribeDBInstances operation to query instance ID.
    * 
    * This parameter is required.
    * 
@@ -15,7 +15,7 @@ export class UpgradeDBProxyInstanceKernelVersionRequest extends $dara.Model {
   DBInstanceId?: string;
   /**
    * @remarks
-   * A reserved parameter. You do not need to configure this parameter.
+   * A reserved parameter. You do not need to specify this parameter.
    * 
    * @example
    * normal
@@ -26,19 +26,26 @@ export class UpgradeDBProxyInstanceKernelVersionRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The specified time. Format: <i>yyyy-MM-dd</i>T<i>HH:mm:ss</i>Z (UTC).
-   * >This parameter is required if **UpgradeTime** is set to **SpecifyTime**.
+   * The specified time. Specify the time in the <i>yyyy-MM-dd</i>T<i>HH:mm:ss</i>Z format. The time must be in UTC.
+   * >If you set **UpgradeTime** to **SpecifyTime**, you must specify this parameter.
    * 
    * @example
    * 2019-07-10T13:15:12Z
    */
   switchTime?: string;
+  /**
+   * @remarks
+   * The target minor engine version.
+   * 
+   * @example
+   * 2.25.9_20251028
+   */
   targetMinorVersion?: string;
   /**
    * @remarks
-   * The upgrade time. Valid values:
+   * The time when you want to perform the upgrade. Valid values:
    * 
-   * * **MaintainTime** (default): The upgrade is performed during the [maintenance window](https://help.aliyun.com/document_detail/610402.html).
+   * * **MaintainTime** (default): The upgrade is performed within the [maintenance window](https://help.aliyun.com/document_detail/610402.html).
    * * **Immediate**: The upgrade is performed immediately.
    * * **SpecifyTime**: The upgrade is performed at a specified time.
    * 

package/src/models/UpgradeDbproxyInstanceKernelVersionResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpgradeDBProxyInstanceKernelVersionResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The proxy ID.
+   * The ID of the database proxy.
    * 
    * @example
    * bu9****
@@ -13,7 +13,7 @@ export class UpgradeDBProxyInstanceKernelVersionResponseBody extends $dara.Model
   DBInstanceName?: string;
   /**
    * @remarks
-   * The request ID.
+   * The ID of the request.
    * 
    * @example
    * 44537EC8-DFA2-4745-B579-E733FF2C5B9A
@@ -21,7 +21,7 @@ export class UpgradeDBProxyInstanceKernelVersionResponseBody extends $dara.Model
   requestId?: string;
   /**
    * @remarks
-   * The task ID.
+   * The ID of the task.
    * 
    * @example
    * 334362871

package/src/models/ValidateImportTaskRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ValidateImportTaskRequest extends $dara.Model {
   /**
    * @remarks
-   * The instance ID. You can call the DescribeDBInstances operation to obtain this parameter.
+   * The instance ID. You can call the DescribeDBInstances operation to query the instance ID.
    * 
    * This parameter is required.
    * 
@@ -15,7 +15,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   dbInstanceId?: string;
   /**
    * @remarks
-   * The estimated instance size. Unit: GB.
+   * The estimated size of the instance. Unit: GB.
    * 
    * @example
    * 100
@@ -23,7 +23,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   estimatedSize?: number;
   /**
    * @remarks
-   * The address of the source MySQL instance.
+   * The address of the source MySQL database.
    * 
    * This parameter is required.
    * 
@@ -34,7 +34,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The password of the source MySQL user, encoded in Base64.
+   * The Base64-encoded password of the source MySQL database user.
    * 
    * This parameter is required.
    * 
@@ -44,7 +44,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   password?: string;
   /**
    * @remarks
-   * The port number of the source MySQL instance.
+   * The port number of the source MySQL database.
    * 
    * This parameter is required.
    * 
@@ -54,7 +54,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   port?: number;
   /**
    * @remarks
-   * The region ID. You can call DescribeRegions to obtain this parameter.
+   * The region ID. You can call the DescribeRegions operation to query the region ID.
    * 
    * This parameter is required.
    * 
@@ -72,7 +72,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   sourceInstanceId?: string;
   /**
    * @remarks
-   * The type of the source instance. Valid values:
+   * The type of the source platform. Valid values:
    * - ECS
    * 
    * @example
@@ -91,7 +91,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   streamPort?: number;
   /**
    * @remarks
-   * The username of the source MySQL instance.
+   * The username of the source MySQL database.
    * 
    * This parameter is required.
    * 
@@ -101,7 +101,7 @@ export class ValidateImportTaskRequest extends $dara.Model {
   user?: string;
   /**
    * @remarks
-   * The path of the Xtrabackup tool on the source instance.
+   * The path to the XtraBackup tool on the source instance.
    * 
    * @example
    * /usr/local/bin/xtrabackup

package/src/models/ValidateImportTaskResponseBody.ts

@@ -13,7 +13,7 @@ export class ValidateImportTaskResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The ID of the precheck task.
+   * The ID of the pre-check task.
    * 
    * @example
    * 12345