@alicloud/gpdb20160503 3.5.0 → 3.6.0

package/src/models/CreateDbinstanceRequest.ts

@@ -3,7 +3,21 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class CreateDBInstanceRequestAINodeSpecInfos extends $dara.Model {
+  /**
+   * @remarks
+   * The number of AI nodes.
+   * 
+   * @example
+   * 1
+   */
   AINodeNum?: string;
+  /**
+   * @remarks
+   * The specifications of the AI nodes.
+   * 
+   * @example
+   * ADB.AIMedium.2
+   */
   AINodeSpec?: string;
   static names(): { [key: string]: string } {
     return {
@@ -31,11 +45,13 @@ export class CreateDBInstanceRequestAINodeSpecInfos extends $dara.Model {
 export class CreateDBInstanceRequestTag extends $dara.Model {
   /**
    * @remarks
-   * Tag key. The restrictions are as follows:
+   * The tag key. The following limits apply:
    * 
-   * - It cannot be an empty string.
-   * - It supports up to 128 characters.
-   * - It cannot start with `aliyun` or `acs:`, and it cannot contain `http://` or `https://`.
+   * - The tag key cannot be empty.
+   * 
+   * - The tag key can be up to 128 characters in length.
+   * 
+   * - The tag key cannot start with `aliyun` or `acs:` and cannot contain `http://` or `https://`.
    * 
    * @example
    * TestKey
@@ -43,11 +59,13 @@ export class CreateDBInstanceRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * Tag value. The restrictions are as follows:
+   * The tag value. The following limits apply:
+   * 
+   * - The tag value can be empty.
+   * 
+   * - The tag value can be up to 128 characters in length.
    * 
-   * - It can be an empty string.
-   * - It supports up to 128 characters.
-   * - It cannot start with `acs:`, and it cannot contain `http://` or `https://`.
+   * - The tag value cannot start with `acs:` and cannot contain `http://` or `https://`.
    * 
    * @example
    * TestValue
@@ -77,21 +95,32 @@ export class CreateDBInstanceRequestTag extends $dara.Model {
 }
 
 export class CreateDBInstanceRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The AI node specifications.
+   */
   AINodeSpecInfos?: CreateDBInstanceRequestAINodeSpecInfos[];
   /**
    * @remarks
-   * Backup set ID.
+   * The ID of the backup set.
    * 
-   * > You can call the [DescribeDataBackups](https://help.aliyun.com/document_detail/210093.html) interface to view the backup set IDs of all backup sets under the target instance.
+   * > You can call the [DescribeDataBackups](https://help.aliyun.com/document_detail/210093.html) operation to query the backup set IDs for the source instance.
    * 
    * @example
    * 1111111111
    */
   backupId?: string;
+  /**
+   * @remarks
+   * The cache size for a serverless instance, in GB.
+   * 
+   * @example
+   * 800
+   */
   cacheStorageSize?: string;
   /**
    * @remarks
-   * Idempotence check. For more information, see [How to Ensure Idempotence](https://help.aliyun.com/document_detail/327176.html).
+   * A client token used to ensure the idempotence of the request. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/327176.html).
    * 
    * @example
    * 0c593ea1-3bea-11e9-b96b-88**********
@@ -99,12 +128,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   clientToken?: string;
   /**
    * @remarks
-   * Whether to load sample datasets after the instance is created. The values are as follows:
+   * Specifies whether to load a sample dataset after the instance is created. Valid values:
    * 
-   * - **true**: Load sample datasets.
-   * - **false**: Do not load sample datasets.
+   * - **true**: A sample dataset is loaded.
    * 
-   * > If this parameter is not specified, it defaults to not loading sample datasets.
+   * - **false**: A sample dataset is not loaded.
+   * 
+   * > If this parameter is not specified, a sample dataset is not loaded.
    * 
    * @example
    * false
@@ -112,12 +142,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   createSampleData?: boolean;
   /**
    * @remarks
-   * Instance series. The value description is as follows:
+   * The instance edition. Valid values:
+   * 
+   * - **HighAvailability**: High-availability Edition
    * 
-   * - **HighAvailability**: High availability version.
-   * - **Basic**: Basic version.
+   * - **Basic**: Basic Edition
    * 
-   * > This parameter is required when creating an instance in the storage elastic mode.
+   * > This parameter is required for instances in elastic storage mode.
    * 
    * @example
    * HighAvailability
@@ -125,9 +156,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   DBInstanceCategory?: string;
   /**
    * @remarks
-   * Instance type. For more details, see the supplementary description of the DBInstanceClass parameter.
+   * The instance type. For more information, see the description of the `DBInstanceClass` parameter.
    * 
-   * > This parameter is required when creating a reserved storage mode instance.
+   * > This parameter is required for instances in reserved storage mode.
    * 
    * @example
    * gpdb.group.segsdx1
@@ -135,7 +166,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   DBInstanceClass?: string;
   /**
    * @remarks
-   * Instance description.
+   * The instance description.
    * 
    * @example
    * test
@@ -143,9 +174,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   DBInstanceDescription?: string;
   /**
    * @remarks
-   * Number of compute groups. The values are: 2, 4, 8, 12, 16, 24, 32, 64, 96, 128.
+   * The number of compute groups. Valid values: 2, 4, 8, 12, 16, 24, 32, 64, 96, and 128.
    * 
-   * > This parameter is required when creating a reserved storage mode instance.
+   * > This parameter is required for instances in reserved storage mode.
    * 
    * @example
    * 2
@@ -153,11 +184,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   DBInstanceGroupCount?: string;
   /**
    * @remarks
-   * Instance resource type. The value description is as follows:
+   * The instance resource mode. Valid values:
+   * 
+   * - **StorageElastic**: elastic storage mode
+   * 
+   * - **Serverless**: serverless mode
    * 
-   * - **StorageElastic**: Storage elastic mode.
-   * - **Serverless**: Serverless mode.
-   * - **Classic**: Storage reserved mode.
+   * - **Classic**: reserved storage mode
    * 
    * > This parameter is required.
    * 
@@ -169,13 +202,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   DBInstanceMode?: string;
   /**
    * @remarks
-   * Deployment mode. The values are as follows:
-   * - multiple: Multi-zone deployment.
-   * - single: Single-zone deployment.
+   * The deployment mode. Valid values:
    * 
-   * > 
-   * > - If this parameter is not specified, the default value is single-zone deployment.
-   * > - Currently, only single-zone deployment is supported.
+   * - multiple: multi-AZ deployment.
+   * 
+   * - single: single-AZ deployment.
+   * 
+   * > * If this parameter is not specified, the default value is single.
+   * >
+   * > * Defaults to `single` (single-AZ deployment), which is the only mode currently supported.
    * 
    * @example
    * single
@@ -185,8 +220,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
    * @remarks
    * Specifies whether to enable SSL encryption. Valid values:
    * 
-   * *   **true**
-   * *   **false** (default)
+   * - **true**: SSL encryption is enabled.
+   * 
+   * - **false** (default): SSL encryption is disabled.
    * 
    * @example
    * false
@@ -194,9 +230,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   enableSSL?: boolean;
   /**
    * @remarks
-   * Key ID.
+   * The ID of the encryption key.
    * 
-   * > If the value of the **EncryptionType** parameter is **CloudDisk**, you need to specify the encryption key ID within the same region through this parameter; otherwise, it should be empty.
+   * > If `EncryptionType` is set to `CloudDisk`, you must specify the ID of an encryption key in the same region. Otherwise, leave this parameter empty.
    * 
    * @example
    * 0d2470df-da7b-4786-b981-88888888****
@@ -204,12 +240,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   encryptionKey?: string;
   /**
    * @remarks
-   * Encryption type. The value description is as follows:
+   * The encryption type. Valid values:
    * 
-   * - **NULL**: No encryption (default).
-   * - **CloudDisk**: Enable cloud disk encryption and specify the key through the **EncryptionKey** parameter.
+   * - **NULL**: disables encryption. This is the default value.
    * 
-   * > Once cloud disk encryption is enabled, it cannot be disabled.
+   * - **CloudDisk**: Enables cloud disk encryption. If you select this option, you must also specify a value for `EncryptionKey`.
+   * 
+   * > After cloud disk encryption is enabled, it cannot be disabled.
    * 
    * @example
    * CloudDisk
@@ -217,7 +254,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   encryptionType?: string;
   /**
    * @remarks
-   * Database engine, with the value **gpdb**.
+   * The database engine. Set the value to **gpdb**.
    * 
    * This parameter is required.
    * 
@@ -227,9 +264,11 @@ export class CreateDBInstanceRequest extends $dara.Model {
   engine?: string;
   /**
    * @remarks
-   * Engine version. The values are as follows:
-   * - **6.0**: Version 6.0.
-   * - **7.0**: Version 7.0.
+   * The database engine version. Valid values:
+   * 
+   * - **6.0**
+   * 
+   * - **7.0**
    * 
    * This parameter is required.
    * 
@@ -239,9 +278,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   engineVersion?: string;
   /**
    * @remarks
-   * The idle release wait time. When the duration without business traffic reaches the specified time, the instance will enter the idle state. The unit is seconds, with a minimum value of 60, and the default value is 600.
+   * The period of inactivity, in seconds, after which the instance is considered idle. Minimum value: 60. Default value: 600.
    * 
-   * > This parameter is required only for Serverless auto-scheduling mode instances.
+   * > This parameter is required only for serverless instances that use auto-scheduling.
    * 
    * @example
    * 600
@@ -249,10 +288,11 @@ export class CreateDBInstanceRequest extends $dara.Model {
   idleTime?: number;
   /**
    * @remarks
-   * Instance network type, with the value **VPC**.
+   * The instance network type. Set the value to **VPC**.
    * 
-   * > - Only VPC networks are supported in public cloud.
-   * > - If not specified, it defaults to VPC type.
+   * > - Only VPCs are supported.
+   * >
+   * > - If this parameter is not specified, VPC is used by default.
    * 
    * @example
    * VPC
@@ -260,24 +300,33 @@ export class CreateDBInstanceRequest extends $dara.Model {
   instanceNetworkType?: string;
   /**
    * @remarks
-   * Compute node specifications.
+   * The instance type for the compute nodes.
+   * 
+   * Valid values for a High-availability Edition instance in elastic storage mode:
    * 
-   * For high-availability versions of the elastic storage mode, the values are as follows:
    * - **2C16G**
+   * 
    * - **4C32G**
+   * 
    * - **16C128G**
    * 
-   * For basic versions of the elastic storage mode, the values are as follows:
+   * Valid values for a Basic Edition instance in elastic storage mode:
+   * 
    * - **2C8G**
+   * 
    * - **4C16G**
+   * 
    * - **8C32G**
+   * 
    * - **16C64G**
    * 
-   * For Serverless mode, the values are as follows:
+   * Valid values for a serverless instance:
+   * 
    * - **4C16G**
+   * 
    * - **8C32G**
    * 
-   * > This parameter is required when creating an elastic storage mode instance or a Serverless mode instance.
+   * > This parameter is required for instances in elastic storage mode or serverless mode.
    * 
    * @example
    * 2C16G
@@ -285,12 +334,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   instanceSpec?: string;
   /**
    * @remarks
-   * This parameter must be specified if you want to change coordinator nodes to AI coordinator nodes.
+   * Use this parameter to configure the coordinator node as a MasterAI node.
    * 
-   * >-  You cannot specify the MasterAISpec and MasterCU parameters at the same time.
-   * >- You can change coordinator nodes to AI coordinator nodes only in specific regions and zones.
-   * >- Only AnalyticDB for PostgreSQL V7.0 instances of Basic Edition support AI coordinator nodes.
-   * >- You can view the valid values of this parameter on the configuration change page of coordinator nodes.
+   * > - This parameter and `MasterCU` are mutually exclusive.
+   * >
+   * > - This feature is available only in some regions and zones.
+   * >
+   * > - MasterAI nodes are supported only for AnalyticDB for PostgreSQL V7.0 Basic Edition instances.
+   * >
+   * > - For a list of all possible values, see the coordinator node specification change page in the console.
    * 
    * @example
    * ADB.AIMedium.2
@@ -298,13 +350,19 @@ export class CreateDBInstanceRequest extends $dara.Model {
   masterAISpec?: string;
   /**
    * @remarks
-   * Master resources, with the following values: 
-   * - 2 CU 
-   * - 4 CU 
-   * - 8 CU 
-   * - 16 CU 
-   * - 32 CU 
-   * > Master resources above 8 CU will incur charges.
+   * The resources for the coordinator node. Valid values:
+   * 
+   * - 2 CU
+   * 
+   * - 4 CU
+   * 
+   * - 8 CU
+   * 
+   * - 16 CU
+   * 
+   * - 32 CU
+   * 
+   * > You are charged for coordinator node resources of 8 CUs or more.
    * 
    * @example
    * 8 CU
@@ -312,7 +370,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   masterCU?: number;
   /**
    * @remarks
-   * This parameter is deprecated and should not be passed.
+   * This parameter is deprecated.
    * 
    * @example
    * null
@@ -321,16 +379,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The billing method of the instance. Valid values:
-   * 
-   * *   **Postpaid**: pay-as-you-go.
-   * *   **Prepaid**: subscription.
+   * The billing method for the instance. Valid values:
    * 
-   * > 
+   * - **Postpaid**: pay-as-you-go.
    * 
-   * *   If you do not specify this parameter, Postpaid is used.
+   * - **Prepaid**: subscription.
    * 
-   * *   You can obtain more cost savings if you create a subscription instance for one year or longer. We recommend that you select the billing method that best suits your needs.
+   * > * If this parameter is not specified, the default billing method is pay-as-you-go.
+   * >
+   * > * Discounts are available for subscriptions of one year or longer. Select a billing method based on your business needs.
    * 
    * @example
    * Prepaid
@@ -338,11 +395,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   payType?: string;
   /**
    * @remarks
-   * Unit of the duration for which resources are purchased. The values are as follows:
-   * - **Month**: Month
-   * - **Year**: Year
+   * The unit of the subscription duration. Valid values:
    * 
-   * > This parameter is required when creating a subscription-billed instance.
+   * - **Month**
+   * 
+   * - **Year**
+   * 
+   * > This parameter is required for subscription instances.
    * 
    * @example
    * Month
@@ -350,7 +409,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   period?: string;
   /**
    * @remarks
-   * This parameter is deprecated and should not be passed.
+   * This parameter is deprecated.
    * 
    * @example
    * null
@@ -358,11 +417,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   privateIpAddress?: string;
   /**
    * @remarks
-   * Product type. The values are as follows:
+   * The product type. Valid values:
+   * 
    * - **standard**: Standard Edition.
-   * - **cost-effective**: Cost-Effective Edition.
    * 
-   * > If this parameter is not specified, the default value is Standard Edition.
+   * - **cost-effective**: Cost-effective Edition.
+   * 
+   * > If this parameter is not specified, the default value is standard.
    * 
    * @example
    * standard
@@ -370,9 +431,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   prodType?: string;
   /**
    * @remarks
-   * Region ID.
+   * The ID of the region for the instance.
    * 
-   * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) interface to view available region IDs.
+   * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) operation to query the IDs of available regions.
    * 
    * This parameter is required.
    * 
@@ -382,7 +443,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the enterprise resource group where the instance is located.
+   * The ID of the resource group for the instance.
    * 
    * @example
    * rg-bp67acfmxazb4p****
@@ -390,9 +451,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   resourceGroupId?: string;
   /**
    * @remarks
-   * The IP address whitelist of the instance.
+   * The IP address whitelist for the instance.
    * 
-   * A value of 127.0.0.1 denies access from any external IP address. You can call the [ModifySecurityIps](https://help.aliyun.com/document_detail/86928.html) operation to modify the IP address whitelist after you create an instance.
+   * A value of 127.0.0.1 blocks all external access. After you create the instance, you can call the [ModifySecurityIps](https://help.aliyun.com/document_detail/86928.html) operation to modify the IP address whitelist.
    * 
    * @example
    * 127.0.0.1
@@ -400,17 +461,17 @@ export class CreateDBInstanceRequest extends $dara.Model {
   securityIPList?: string;
   /**
    * @remarks
-   * The performance level of ESSDs. Valid values:
+   * The performance level of the ESSDs. Valid values:
    * 
-   * *   **pl0**
-   * *   **pl1**
-   * *   **pl2**
+   * - **pl0**: PL0
    * 
-   * > 
+   * - **pl1**: PL1
    * 
-   * *   This parameter takes effect only when SegStorageType is set to cloud_essd.
+   * - **pl2**: PL2
    * 
-   * *   If you do not specify this parameter, pl1 is used.
+   * > * This parameter applies only if the segment node storage type is ESSD.
+   * >
+   * > * If this parameter is not specified, pl1 is used by default.
    * 
    * @example
    * pl1
@@ -418,13 +479,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   segDiskPerformanceLevel?: string;
   /**
    * @remarks
-   * The number of compute nodes. The value description is as follows:
+   * The number of compute nodes. Valid values:
    * 
-   * - For the high-availability version of the storage elastic mode, the value range is 4 to 512, and the value must be a multiple of 4.
-   * - For the basic version of the storage elastic mode, the value range is 2 to 512, and the value must be a multiple of 2.
-   * - For the Serverless mode, the value range is 2 to 512, and the value must be a multiple of 2.
+   * - For a High-availability Edition instance in elastic storage mode, the value must be a multiple of 4, from 4 to 512.
    * 
-   * > This parameter is required when creating instances in the storage elastic mode or Serverless mode.
+   * - For a Basic Edition instance in elastic storage mode, the value must be a multiple of 2, from 2 to 512.
+   * 
+   * - For a serverless instance, the value must be a multiple of 2, from 2 to 512.
+   * 
+   * > This parameter is required for instances in elastic storage mode or serverless mode.
    * 
    * @example
    * 4
@@ -432,9 +495,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   segNodeNum?: string;
   /**
    * @remarks
-   * Disk storage type, currently only ESSD cloud disks are supported, with the value **cloud_essd**.
+   * The storage type for the segment nodes. Only ESSDs are supported. Set the value to **cloud_essd**.
    * 
-   * > This parameter is required when creating an elastic storage mode instance.
+   * > This parameter is required for instances in elastic storage mode.
    * 
    * @example
    * cloud_essd
@@ -442,12 +505,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   segStorageType?: string;
   /**
    * @remarks
-   * The mode of the Serverless instance. The values are as follows:
+   * The mode of the serverless instance. Valid values:
    * 
-   * - **Manual**: Manual scheduling (default).
-   * - **Auto**: Auto scheduling.
+   * - **Manual**: manual scheduling. This is the default value.
    * 
-   * > This parameter is required only for Serverless mode instances.
+   * - **Auto**: auto-scheduling.
+   * 
+   * > * This parameter is required only for instances in serverless mode.
+   * >
+   * > * Auto-scheduling for AnalyticDB for PostgreSQL instances in serverless mode is in preview. To use this feature, [submit a ticket](https://smartservice.console.aliyun.com/service/create-ticket?product=rds) to be added to the whitelist.
    * 
    * @example
    * Auto
@@ -455,9 +521,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   serverlessMode?: string;
   /**
    * @remarks
-   * The threshold for computing resources. The value range is 8 to 32, with a step of 8, and the unit is ACU. The default value is 32.
+   * The threshold for computing resources, in AnalyticDB Compute Units (ACUs). The value must be a multiple of 8, ranging from 8 to 32. The default value is 32.
    * 
-   * > This parameter is required only for Serverless auto-scheduling mode instances.
+   * > This parameter is required only for serverless instances that use auto-scheduling.
    * 
    * @example
    * 32
@@ -465,9 +531,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   serverlessResource?: number;
   /**
    * @remarks
-   * ID of the source instance to be cloned.
+   * The ID of the source instance to be cloned.
    * 
-   * > You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) interface to view details of all AnalyticDB for PostgreSQL instances in the target region, including the instance ID.
+   * > You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) operation to query the details of all AnalyticDB for PostgreSQL instances in the destination region, including instance IDs.
    * 
    * @example
    * gp-bp***************
@@ -475,11 +541,11 @@ export class CreateDBInstanceRequest extends $dara.Model {
   srcDbInstanceName?: string;
   /**
    * @remarks
-   * VSwitch ID of the standby zone.
+   * The ID of the vSwitch in the standby zone.
    * 
-   * > 
-   * > - This parameter is required for multi-zone deployment.
-   * > - The VSwitch ID of the standby zone must be in the same zone as the StandbyZoneId.
+   * > - This parameter is required only for a multi-AZ deployment.
+   * >
+   * > - The vSwitch must be in the standby zone specified in `StandbyZoneId`.
    * 
    * @example
    * vsw-bp1cpq8mr64paltkb****
@@ -487,12 +553,13 @@ export class CreateDBInstanceRequest extends $dara.Model {
   standbyVSwitchId?: string;
   /**
    * @remarks
-   * ID of the standby zone.
+   * The ID of the standby zone.
    * 
-   * > 
-   * > - This parameter is required for multi-zone deployment.
-   * > - You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) interface to view available zone IDs.
-   * > - The ID of the standby zone must be different from the ID of the primary zone.
+   * > - This parameter is required only for a multi-AZ deployment.
+   * >
+   * > - You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) operation to query the IDs of available zones.
+   * >
+   * > - The standby zone must be different from the primary zone.
    * 
    * @example
    * cn-hangzhou-j
@@ -500,9 +567,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   standbyZoneId?: string;
   /**
    * @remarks
-   * The size of the storage space, in GB, with a value range of <props="china">50~8000<props="intl">50~6000.
+   * The storage capacity for the instance, in GB. Valid values: <props="china">50 to 8000<props="intl">50 to 6000.
    * 
-   * > This parameter is required when creating an instance in the storage elastic mode.
+   * > This parameter is required for instances in elastic storage mode.
    * 
    * @example
    * 200
@@ -510,7 +577,7 @@ export class CreateDBInstanceRequest extends $dara.Model {
   storageSize?: number;
   /**
    * @remarks
-   * This parameter is deprecated and should not be passed.
+   * This parameter is deprecated.
    * 
    * @example
    * null
@@ -518,16 +585,18 @@ export class CreateDBInstanceRequest extends $dara.Model {
   storageType?: string;
   /**
    * @remarks
-   * The Nth tag. The value of N ranges from 1 to 20.
+   * The tags to add to the instance. You can add up to 20 tags.
    */
   tag?: CreateDBInstanceRequestTag[];
   /**
    * @remarks
-   * Duration for which resources are purchased. The values are as follows:
-   * - When **Period** is **Month**, the value ranges from 1 to 9.
-   * - When **Period** is **Year**, the value ranges from 1 to 3.
+   * The subscription duration. Valid values:
+   * 
+   * - If **Period** is **Month**, the value can be an integer from 1 to 9.
    * 
-   * > This parameter is required when creating a subscription-billed instance.
+   * - If **Period** is **Year**, the value can be an integer from 1 to 3.
+   * 
+   * > This parameter is required for subscription instances.
    * 
    * @example
    * 1
@@ -535,10 +604,11 @@ export class CreateDBInstanceRequest extends $dara.Model {
   usedTime?: string;
   /**
    * @remarks
-   * VPC ID.
+   * The VPC ID.
    * 
-   * > - **VPCId** is required.
-   * > - The region of the **VPC** must be consistent with **RegionId**.
+   * > - This parameter is required.
+   * >
+   * > - The VPC must be in the region specified by `RegionId`.
    * 
    * @example
    * vpc-bp19ame5m1r3oejns****
@@ -546,10 +616,11 @@ export class CreateDBInstanceRequest extends $dara.Model {
   VPCId?: string;
   /**
    * @remarks
-   * vSwitch ID.
+   * The vSwitch ID.
    * 
-   * > - **vSwitchId** is required.
-   * > - The availability zone of the **vSwitch** must be consistent with **ZoneId**.
+   * > - This parameter is required.
+   * >
+   * > - The vSwitch must be in the zone specified by `ZoneId`.
    * 
    * @example
    * vsw-bp1cpq8mr64paltkb****
@@ -557,12 +628,15 @@ export class CreateDBInstanceRequest extends $dara.Model {
   vSwitchId?: string;
   /**
    * @remarks
-   * Whether to enable vector engine optimization. The value description is as follows:
-   * - **enabled**: Enable vector engine optimization.
-   * - **disabled** (default): Do not enable vector engine optimization.
+   * Specifies whether to enable vector engine optimization. Valid values:
+   * 
+   * - **enabled**: enables vector engine optimization.
+   * 
+   * - **disabled** (default): disables vector engine optimization.
    * 
-   * > - For mainstream analysis scenarios, data warehouse scenarios, and real-time data warehouse scenarios, it is recommended to **not enable** vector engine optimization.
-   * > - For users using the vector analysis engine for AIGC, vector retrieval, and other scenarios, it is recommended to **enable** vector engine optimization.
+   * > * For mainstream analytics, data warehousing, and real-time data warehousing scenarios, we recommend that you **disable** vector engine optimization.
+   * >
+   * > * For AIGC and vector search scenarios, we recommend that you **enable** vector engine optimization.
    * 
    * @example
    * enabled
@@ -570,9 +644,9 @@ export class CreateDBInstanceRequest extends $dara.Model {
   vectorConfigurationStatus?: string;
   /**
    * @remarks
-   * Zone ID.
+   * The ID of the zone for the instance.
    * 
-   * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) interface to view available zone IDs.
+   * > You can call the [DescribeRegions](https://help.aliyun.com/document_detail/86912.html) operation to query the IDs of available zones.
    * 
    * This parameter is required.
    *