@alicloud/ecs20140526 7.8.5 → 7.9.0

package/src/models/ModifyInstanceAttributeRequest.ts

@@ -5,11 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyInstanceAttributeRequestCpuOptions extends $dara.Model {
   /**
    * @remarks
-   * The number of CPU cores. This parameter is not customizable and uses a default value.
+   * The number of CPU cores. This parameter does not support custom values and can only use the default value.
    * 
-   * <props="china">
-   * 
-   * For information about the default value, see [Custom CPU options](https://help.aliyun.com/document_detail/145895.html).
+   * <props="china">Default value: see [Customize CPU options](https://help.aliyun.com/document_detail/145895.html).
    * 
    * @example
    * 2
@@ -17,15 +15,13 @@ export class ModifyInstanceAttributeRequestCpuOptions extends $dara.Model {
   core?: number;
   /**
    * @remarks
-   * The number of threads per core. The total number of vCPUs for an ECS instance is the value of `CpuOptions.Core` multiplied by the value of `CpuOptions.ThreadsPerCore`.
-   * 
-   * - Setting `CpuOptions.ThreadsPerCore` to 1 disables hyper-threading.
+   * The number of threads per CPU core. The number of vCPUs of the ECS instance = CpuOptions.Core value × CpuOptions.ThreadsPerCore value.
    * 
-   * - Only some instance types support specifying the number of threads per core.
+   * - CpuOptions.ThreadsPerCore=1 indicates that hyper-threading is disabled.
    * 
-   * <props="china">
+   * - Only some instance types support custom thread counts.
    * 
-   * For information about the valid values and default value, see [Custom CPU options](https://help.aliyun.com/document_detail/145895.html).
+   * <props="china">Valid values and default value: see [Customize CPU options](https://help.aliyun.com/document_detail/145895.html).
    * 
    * @example
    * 2
@@ -35,17 +31,15 @@ export class ModifyInstanceAttributeRequestCpuOptions extends $dara.Model {
    * @remarks
    * The CPU topology type of the instance. Valid values:
    * 
-   * - ContinuousCoreToHTMapping: The hyper-threads of the same core are contiguous.
-   * 
-   * - DiscreteCoreToHTMapping: The hyper-threads of the same core are discrete.
-   * 
-   * Default value: None.
+   * - ContinuousCoreToHTMapping: the hyper-threads of the same core in the CPU topology are continuous.
+   * - DiscreteCoreToHTMapping: the hyper-threads of the same core are discrete.
    * 
-   * Note the following when you use this parameter:
+   * Default value: none.
    * 
-   * - The instance must be in the `Stopped` state.
+   * Take note of the following items:
+   * - The instance must be in the Stopped state.
    * 
-   * > This parameter is supported by only some instance families. See [View and modify the CPU topology](https://help.aliyun.com/document_detail/2636059.html) for a list of supported families.
+   * > Only some instance families support this parameter. For information about the supported instance families, see [View and modify the CPU topology structure](https://help.aliyun.com/document_detail/2636059.html).
    * 
    * @example
    * DiscreteCoreToHTMapping
@@ -53,7 +47,7 @@ export class ModifyInstanceAttributeRequestCpuOptions extends $dara.Model {
   topologyType?: string;
   /**
    * @remarks
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * > This parameter is in invitational preview and is not publicly available.
    * 
    * @example
    * enabled
@@ -89,11 +83,10 @@ export class ModifyInstanceAttributeRequestCpuOptions extends $dara.Model {
 export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable resolution of the instance ID-based domain name to an IPv6 address. Valid values:
-   * 
-   * - true
-   * 
-   * - false
+   * Specifies whether to enable DNS resolution from the instance ID-based domain name to the IPv6 address. Valid values:
+   *  
+   * - true: enables the resolution.
+   * - false: disables the resolution.
    * 
    * Default value: false.
    * 
@@ -103,11 +96,10 @@ export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.M
   enableInstanceIdDnsAAAARecord?: boolean;
   /**
    * @remarks
-   * Specifies whether to enable resolution of the instance ID-based domain name to an IPv4 address. Valid values:
-   * 
-   * - true
-   * 
-   * - false
+   * Specifies whether to enable DNS resolution from the instance ID-based domain name to the IPv4 address. Valid values:
+   *  
+   * - true: enables the resolution.
+   * - false: disables the resolution.
    * 
    * Default value: false.
    * 
@@ -117,11 +109,9 @@ export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.M
   enableInstanceIdDnsARecord?: boolean;
   /**
    * @remarks
-   * Specifies whether to enable resolution of the IP address-based domain name to an IPv4 address. Valid values:
-   * 
-   * - true
-   * 
-   * - false
+   * Specifies whether to enable DNS resolution from the IP-based domain name to the IPv4 address. Valid values:
+   * - true: enables the resolution.
+   * - false: disables the resolution.
    * 
    * Default value: false.
    * 
@@ -131,11 +121,9 @@ export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.M
   enableIpDnsARecord?: boolean;
   /**
    * @remarks
-   * Specifies whether to enable reverse DNS resolution of an IPv4 address to an IP address-based domain name. Valid values:
-   * 
-   * - true
-   * 
-   * - false
+   * Specifies whether to enable reverse DNS resolution from the IPv4 address to the IP-based domain name. Valid values:
+   * - true: enables the resolution.
+   * - false: disables the resolution.
    * 
    * Default value: false.
    * 
@@ -147,11 +135,9 @@ export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.M
    * @remarks
    * The hostname type. Valid values:
    * 
-   * - Custom: a custom hostname.
-   * 
-   * - IpBased: an IP address-based hostname.
-   * 
-   * - InstanceIdBased: an instance ID-based hostname.
+   * - Custom: custom.
+   * - IpBased: IP-based hostname.
+   * - InstanceIdBased: instance ID-based hostname.
    * 
    * Default value: Custom.
    * 
@@ -191,7 +177,7 @@ export class ModifyInstanceAttributeRequestPrivateDnsNameOptions extends $dara.M
 export class ModifyInstanceAttributeRequestRemoteConnectionOptions extends $dara.Model {
   /**
    * @remarks
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * > This parameter is in invitational preview and is not publicly available.
    * 
    * @example
    * hide
@@ -199,7 +185,7 @@ export class ModifyInstanceAttributeRequestRemoteConnectionOptions extends $dara
   password?: string;
   /**
    * @remarks
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * > This parameter is in invitational preview and is not publicly available.
    * 
    * @example
    * hide
@@ -232,13 +218,12 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   cpuOptions?: ModifyInstanceAttributeRequestCpuOptions;
   /**
    * @remarks
-   * The performance mode of the burstable performance instance. Valid values:
+   * The running mode of the burstable instance. Valid values:
    * 
    * - Standard: standard mode.
-   * 
    * - Unlimited: unlimited mode.
    * 
-   * For more information about the performance modes of burstable performance instances, see [Overview of burstable performance instances](https://help.aliyun.com/document_detail/59977.html).
+   * For more information about the running modes of burstable instances, see [What are burstable instances?](https://help.aliyun.com/document_detail/59977.html).
    * 
    * @example
    * Standard
@@ -246,9 +231,9 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   creditSpecification?: string;
   /**
    * @remarks
-   * Specifies whether to enable deletion protection for the instance. This setting prevents the instance from being released from the console or by calling the [DeleteInstance](https://help.aliyun.com/document_detail/25507.html) operation.
+   * The release protection attribute of the instance. Specifies whether the instance can be released from the console or by calling [DeleteInstance](https://help.aliyun.com/document_detail/25507.html).
    * 
-   * > This feature applies only to pay-as-you-go instances and protects instances only from manual release operations. It does not affect system-initiated release operations.
+   * > This attribute applies only to pay-as-you-go instances and only prevents manual release operations. It does not apply to system-initiated release operations.
    * 
    * @example
    * false
@@ -256,7 +241,7 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   deletionProtection?: boolean;
   /**
    * @remarks
-   * The instance description. The description must be 2 to 256 characters long and cannot start with `http://` or `https://`.
+   * The description of the instance. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.
    * 
    * @example
    * testInstanceDescription
@@ -264,19 +249,16 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * Specifies whether to enable jumbo frames. When jumbo frames are enabled, the MTU of the instance is 8500. When jumbo frames are disabled, the MTU of the instance is 1500. Valid values:
-   * 
-   * - true
+   * Specifies whether to enable the Jumbo Frame feature for the instance MTU. Valid values:
    * 
-   * - false
+   * - true: enables the feature.
+   * - false: does not enable the feature.
    * 
-   * Note the following when you use this parameter:
-   * 
-   * - The instance must be in the `Running` or `Stopped` state.
-   * 
-   * - The instance must be in a VPC.
-   * 
-   * - Only some instance types support jumbo frames. For more information, see [ECS instance MTU](https://help.aliyun.com/document_detail/200512.html).
+   * Take note of the following items:
+   * - The instance must be in the Running or Stopped state.
+   * - The instance must be a VPC-connected instance.
+   * - After the Jumbo Frame feature is enabled, the MTU value of the instance changes to 8500. After the feature is disabled, the MTU value reverts to 1500.
+   * Only some instance types support the Jumbo Frame feature. For more information, see [ECS instance MTU](https://help.aliyun.com/document_detail/200512.html).
    * 
    * @example
    * false
@@ -286,11 +268,9 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
    * @remarks
    * Specifies whether to enable VPC network traffic encryption. Valid values:
    * 
-   * - true
-   * 
-   * - false
-   * 
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * - true: enables the encryption.
+   * - false: disables the encryption.
+   * > This parameter is in invitational preview and is not publicly available.
    * 
    * @example
    * true
@@ -298,17 +278,18 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   enableNetworkEncryption?: boolean;
   /**
    * @remarks
-   * The hostname of the operating system. Note the following when you use this parameter:
+   * The hostname of the operating system. Take note of the following items:
+   * 
+   * - The instance cannot be in the Pending or Starting state. Otherwise, the hostname and `/etc/hosts` configuration may not take effect. You can call [DescribeInstances](https://help.aliyun.com/document_detail/25506.html) to query the current status of the instance.
    * 
-   * - The instance cannot be in the `Pending` or `Starting` state. Otherwise, the specified hostname and the `/etc/hosts` configuration may not take effect. You can call the [DescribeInstances](https://help.aliyun.com/document_detail/25506.html) operation to query the current state of the instance.
+   * - The new hostname takes effect after you restart the instance. You can restart the instance in the ECS console (for more information, see [Restart an instance](https://help.aliyun.com/document_detail/25440.html)) or by calling [RebootInstance](https://help.aliyun.com/document_detail/25502.html). Restarting the instance from within the operating system does not take effect.
    * 
-   * - The new hostname takes effect after you restart the instance from the ECS console (see [Restart an instance](https://help.aliyun.com/document_detail/25440.html)) or by calling the [RebootInstance](https://help.aliyun.com/document_detail/25502.html) operation. Restarting the instance from within its operating system does not apply the change.
    * 
-   * The hostname must meet the following requirements for different operating systems:
+   * The hostname has the following limits for different operating systems:
    * 
-   * - For Windows Server instances: The hostname must be 2 to 15 characters long and contain letters, digits, and hyphens (-). It cannot start or end with a hyphen, contain consecutive hyphens, or consist of only digits.
+   * - Windows Server: The hostname must be 2 to 15 characters in length and can contain uppercase letters, lowercase letters, digits, and hyphens (-). It cannot start or end with a hyphen (-), cannot contain consecutive hyphens (-), and cannot contain only digits.
    * 
-   * - For other types of instances (such as Linux): The hostname must be 2 to 64 characters long. You can use periods (.) to separate the hostname into segments. Each segment can contain letters, digits, and hyphens (-). The hostname cannot start or end with a period or hyphen, and cannot contain consecutive periods or hyphens.
+   * - Other instances (such as Linux): The hostname must be 2 to 64 characters in length. You can use periods (.) to separate the hostname into multiple segments. Each segment can contain uppercase letters, lowercase letters, digits, and hyphens (-), but cannot contain consecutive periods (.) or hyphens (-). The hostname cannot start or end with a period (.) or hyphen (-).
    * 
    * @example
    * testHostName
@@ -316,7 +297,7 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   hostName?: string;
   /**
    * @remarks
-   * The ID of the instance.
+   * The instance ID.
    * 
    * This parameter is required.
    * 
@@ -326,7 +307,7 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The instance name. The name must be 2 to 128 characters long. It must start with a letter or a Chinese character and cannot start with `http://` or `https://`. The name can contain digits, colons (:), underscores (_), and hyphens (-).
+   * The name of the instance. The name must be 2 to 128 characters in length. It must start with an uppercase letter, lowercase letter, or Chinese character and cannot start with `http://` or `https://`. The name can contain digits, colons (:), underscores (_), and hyphens (-).
    * 
    * @example
    * testInstanceName
@@ -334,13 +315,10 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   instanceName?: string;
   /**
    * @remarks
-   * The number of queues for the primary network interface. Note the following when you use this parameter:
-   * 
-   * - The instance must be in the `Stopped` state.
-   * 
-   * - The value cannot exceed the maximum number of queues that the instance type supports for a single network interface. The total number of queues across all network interfaces of the instance cannot exceed the total queue quota that the instance type supports. You can call the [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) operation to query the maximum number of queues per network interface and the total queue quota for an instance type.
-   * 
-   * - If you set this parameter to -1, the number of queues for the primary network interface is reset to the default value for the instance type. You can call the [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) operation to query the default number of queues for an elastic network interface of an instance type.
+   * The number of queues for the primary network interface controller (NIC). Take note of the following items:
+   * - The instance must be in the Stopped state.
+   * - The value cannot exceed the maximum number of queues per NIC allowed by the instance type. The total number of queues for all NICs on the instance cannot exceed the total queue quota allowed by the instance type. You can call [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to query the maximum number of queues per NIC and the total queue quota for an instance type.
+   * - If you set this parameter to -1, the number of queues for the primary NIC is reset to the default value for the instance type. You can call [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to query the default number of Elastic Network Interface (ENI) queues for an instance type.
    * 
    * @example
    * 8
@@ -350,13 +328,13 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The password of the instance. The password must be 8 to 30 characters long and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The supported special characters are **()\\~!@#$%^&\\*-_+=|{}[]:;\\"<>,.?/**. For a Windows instance, the password cannot start with a forward slash (/). Note the following when you use this parameter:
-   * 
-   * - The instance cannot be in the `Starting` state.
+   * The password of the instance. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The following special characters are supported: **()`~!@#$%^&*-_+=|{}[]:;\\"<>,.?/**
+   * . For Windows instances, the password cannot start with a forward slash (/). Take note of the following items:
    * 
-   * - The new password takes effect after you restart the instance from the ECS console (see [Restart an instance](https://help.aliyun.com/document_detail/25440.html)) or by calling the [RebootInstance](https://help.aliyun.com/document_detail/25502.html) operation. Restarting the instance from within its operating system does not apply the change.
+   * - The instance cannot be in the Starting state.
+   * - The new password takes effect after you restart the instance. You can restart the instance in the ECS console (for more information, see [Restart an instance](https://help.aliyun.com/document_detail/25440.html)) or by calling [RebootInstance](https://help.aliyun.com/document_detail/25502.html). Restarting the instance from within the operating system does not take effect.
    * 
-   * > To prevent password exposure, send requests that include the `Password` parameter over HTTPS.
+   * > If you specify the Password parameter, use HTTPS to send the request to avoid password leaks.
    * 
    * @example
    * Test123456&$
@@ -364,15 +342,15 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   password?: string;
   /**
    * @remarks
-   * The private DNS name settings for the instance.
+   * The private domain name configuration of the instance.
    * 
-   * For more information about private DNS name resolution, see [ECS private DNS resolution
-   * ](https://help.aliyun.com/document_detail/2844797.html).
+   * 
+   * For more information about private private domain resolution, see [ECS private private domain resolution](https://help.aliyun.com/document_detail/2844797.html).
    */
   privateDnsNameOptions?: ModifyInstanceAttributeRequestPrivateDnsNameOptions;
   /**
    * @remarks
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * > This parameter is in invitational preview and is not publicly available.
    * 
    * @example
    * true
@@ -380,26 +358,21 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   recyclable?: boolean;
   /**
    * @remarks
-   * > This parameter is in invitation-only preview and is not publicly available.
+   * > This parameter is in invitational preview and is not publicly available.
    */
   remoteConnectionOptions?: ModifyInstanceAttributeRequestRemoteConnectionOptions;
   resourceOwnerAccount?: string;
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The IDs of security groups to assign to the instance. Note the following when you use this parameter:
-   * 
-   * - The security group IDs in the array must be unique. The number of security groups that an instance can join is limited. For more information, see [Limits](~~25412#SecurityGroupQuota1~~).
-   * 
-   * - Specifying this parameter removes the instance from its current security groups. To retain existing security group associations, you must include their IDs in this array.
-   * 
-   * - You can switch the security group type. However, the specified security groups cannot include both basic and enterprise security groups.
+   * The IDs of the security groups to which the instance is reassigned. Take note of the following items:
    * 
+   * - Security group IDs in the array cannot be duplicated. The maximum length of the array depends on the maximum number of security groups to which the instance can belong. For more information, see [Limits](~~25412#SecurityGroupQuota1~~).
+   * - The instance leaves its current security groups. To retain the current security groups, add their IDs to the array.
+   * - You can switch between security group types, but the list cannot contain both basic security groups and advanced security groups at the same time.
    * - The security groups must belong to the same VPC as the instance.
    * 
-   * - This parameter is not supported for instances in the classic network.
-   * 
-   * > The change takes effect on the instance after a short delay.
+   * > Changes to security groups take effect on the instance shortly after the modification, but a slight delay may occur.
    * 
    * @example
    * sg-bp15ed6xe1yxeycg7o****
@@ -407,13 +380,12 @@ export class ModifyInstanceAttributeRequest extends $dara.Model {
   securityGroupIds?: string[];
   /**
    * @remarks
-   * The user data of the instance. User data should be Base64-encoded before it is passed. Note the following when you use this parameter:
-   * 
-   * - The user data must comply with the limits described in [Generate user data](https://help.aliyun.com/document_detail/49121.html).
+   * The instance user data. We recommend that you Base64-encode the data before you pass it in. Take note of the following items:
    * 
-   * - After you restart the instance, the new user data is available on the instance but is not executed.
+   * - The instance must meet the usage limits for instance user data. For more information, see [Create instance user data](https://help.aliyun.com/document_detail/49121.html).
+   * - After you restart the instance, the new user data is displayed on the instance but is not run.
    * 
-   * > The raw data cannot exceed 32 KB before being encoded. Do not pass confidential information, such as passwords and private keys, in plaintext. If you must pass confidential information, encrypt and then Base64-encode it. On the instance, decrypt the information by using the corresponding decryption method.
+   * > Before Base64 encoding, the raw data cannot exceed 32 KB. Do not pass in sensitive information such as passwords and private keys in plaintext. If you must pass in sensitive information, encrypt the information, Base64-encode it, and then decrypt it in the same way within the instance.
    * 
    * @example
    * ZWNobyBoZWxsbyBlY3Mh

package/src/models/ModifyInstanceAutoRenewAttributeRequest.ts

@@ -5,11 +5,10 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable auto-renewal.
+   * Specifies whether to automatically renew the instance before it expires.
    * 
-   * - true
-   * 
-   * - false
+   * - true: enables auto-renewal.
+   * - false: disables auto-renewal.
    * 
    * Default value: false.
    * 
@@ -19,11 +18,24 @@ export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
   autoRenew?: boolean;
   /**
    * @remarks
-   * The auto-renewal period of the instance.
+   * The auto-renewal duration of the instance.
+   * 
+   * <props="china">
+   * - When `PeriodUnit` is set to `Year`, the valid values of `Duration` are: {"1", "2", "3", "4", "5"}
+   * - When `PeriodUnit` is set to `Month`, the valid values of `Duration` are: {"1", "2", "3", "6", "12", "24", "36", "48", "60"}
+   * - When `PeriodUnit` is set to `Week`, the valid values of `Duration` are: {"1", "2", "3", "4"}
+   * 
+   * 
    * 
-   * - Valid values of `Duration` when `PeriodUnit` is set to `Year`: 1, 2, 3, 4, and 5.
+   * <props="intl">
+   * - When `PeriodUnit` is set to `Year`, the valid values of `Duration` are: {"1", "2", "3", "4", "5"}
+   * - When `PeriodUnit` is set to `Month`, the valid values of `Duration` are: {"1", "2", "3", "6", "12", "24", "36", "48", "60"}
    * 
-   * - Valid values of `Duration` when `PeriodUnit` is set to `Month`: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
+   * 
+   * 
+   * <props="partner">
+   * - When `PeriodUnit` is set to `Year`, the valid values of `Duration` are: {"1", "2", "3", "4", "5"}
+   * - When `PeriodUnit` is set to `Month`, the valid values of `Duration` are: {"1", "2", "3", "6", "12", "24", "36", "48", "60"}
    * 
    * @example
    * 1
@@ -31,7 +43,7 @@ export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
   duration?: number;
   /**
    * @remarks
-   * The ID of the instance. You can specify up to 100 subscription instance IDs. Separate the instance IDs with commas (,).
+   * Instance ID. You can specify up to 100 subscription instances at a time. Separate multiple instance IDs with commas (,).
    * 
    * This parameter is required.
    * 
@@ -43,10 +55,23 @@ export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The unit of the renewal period (`Duration`). Valid values:
+   * The unit of the renewal duration, that is, the unit of the `Duration` parameter. Valid values:
    * 
+   * <props="china">
+   * - Week
    * - Month (default)
+   * - Year
+   * 
    * 
+   * 
+   * <props="intl">
+   * - Month (default)
+   * - Year
+   * 
+   * 
+   * 
+   * <props="partner">
+   * - Month (default)
    * - Year
    * 
    * @example
@@ -55,7 +80,7 @@ export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
   periodUnit?: string;
   /**
    * @remarks
-   * The region ID of the instance. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
+   * The region ID of the instance. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to view the latest list of Alibaba Cloud regions.
    * 
    * This parameter is required.
    * 
@@ -67,13 +92,13 @@ export class ModifyInstanceAutoRenewAttributeRequest extends $dara.Model {
    * @remarks
    * The auto-renewal status of the instance. Valid values:
    * 
-   * - AutoRenewal: Auto-renewal is enabled for the instance.
+   * - AutoRenewal: enables auto-renewal.
    * 
-   * - Normal: Auto-renewal is disabled for the instance.
+   * - Normal: disables auto-renewal.
    * 
-   * - NotRenewal: The instance is not renewed. The system no longer sends an expiration notification but sends only a renewal notification three days before the instance expires. You can change the value of this parameter from NotRenewal to `Normal` for an instance, and then manually renew the instance. Alternatively, you can set the RenewalStatus parameter to AutoRenewal.
+   * - NotRenewal: does not renew the instance. After this value is set, the system no longer sends expiration reminders and only sends a non-renewal reminder three days before the instance expires. ECS instances that are set to not renew can be changed to pending renewal (`Normal`), and then manually renewed or set to auto-renewal.
    * 
-   * > `RenewalStatus` takes precedence over `AutoRenew`. If you do not specify `RenewalStatus`, `AutoRenew` is used by default.
+   * > The `RenewalStatus` parameter takes precedence over the `AutoRenew` parameter. If the `RenewalStatus` parameter is not specified, the `AutoRenew` parameter takes effect by default.
    * 
    * @example
    * AutoRenewal

package/src/models/ModifyInstanceNetworkSpecRequest.ts

@@ -5,11 +5,10 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to assign a public IP address. Valid values:
+   * Specifies whether to allocate a public IP address.
    * 
-   * - true
-   * 
-   * - false
+   * - true: allocates a public IP address.
+   * - false: does not allocate a public IP address.
    * 
    * Default value: false.
    * 
@@ -19,11 +18,19 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   allocatePublicIp?: boolean;
   /**
    * @remarks
-   * Specifies whether to automatically complete the payment. Valid values:
+   * Specifies whether to enable automatic payment. Valid values:
+   * 
+   * - true: After the bandwidth configuration is modified, the payment is automatically deducted. When you set the AutoPay parameter to true, make sure that your account has sufficient balance. If your account balance is insufficient, an abnormal order is generated. You cannot pay for the order on the ECS console. You can only cancel the order.
+   * 
+   * <props="china">
+   * - false: After the bandwidth configuration is modified, only an order is generated and no payment is made. If your payment method has insufficient balance, you can set the AutoPay parameter to false to disable automatic payment. In this case, the API generates a normal unpaid order. You can log on to the [ECS console](https://ecs.console.aliyun.com) to pay for the order.
+   * 
+   * 
+   * 
+   * <props="intl">
+   * - false: After the bandwidth configuration is modified, only an order is generated and no payment is made. If your payment method has insufficient balance, you can set the AutoPay parameter to false to disable automatic payment. In this case, the API generates a normal unpaid order. You can log on to the [ECS console](https://ecs.console.aliyun.com) to pay for the order.
    * 
-   * - true: After you modify the bandwidth configurations, the payment is automatically completed. Make sure that your account balance is sufficient before you set AutoPay to true. If your account balance is insufficient, your order cannot be paid in the ECS console and becomes invalid. You must cancel the order.
    * 
-   * - false: After you modify the bandwidth configurations, an order is generated but the payment is not automatically completed. If your account balance is insufficient, you can set AutoPay to false to generate an unpaid order. Then, you can log on to the [ECS console](https://ecs.console.aliyun.com) to pay for the order.
    * 
    * Default value: true.
    * 
@@ -33,7 +40,7 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   autoPay?: boolean;
   /**
    * @remarks
-   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. **The token can contain only ASCII characters and cannot exceed 64 characters in length.** For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
+   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The **ClientToken** value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
    * 
    * @example
    * 123e4567-e89b-12d3-a456-426655440000
@@ -41,9 +48,9 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   clientToken?: string;
   /**
    * @remarks
-   * The end time of the temporary bandwidth upgrade. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddThhZ format. The time must be in UTC and accurate to **hours** (hh).
+   * The end time of the temporary bandwidth upgrade. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in UTC+0 time in the yyyy-MM-ddTHHZ format. The time must be accurate to the **hour** (HH).
    * 
-   * > The interval between the end time and start time of temporary bandwidth upgrade must be greater than or equal to 3 hours.
+   * > The interval between the end time and the start time of the temporary bandwidth upgrade must be greater than or equal to 3 hours.
    * 
    * @example
    * 2017-12-06T22Z
@@ -51,7 +58,7 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   endTime?: string;
   /**
    * @remarks
-   * > This parameter is in invitational preview and is not publicly available.
+   * > This parameter is in invitational preview and is not yet available for use.
    * 
    * @example
    * null
@@ -59,7 +66,7 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   ISP?: string;
   /**
    * @remarks
-   * The ID of the instance for which you want to modify network configurations.
+   * The ID of the instance for which you want to modify the network configuration.
    * 
    * This parameter is required.
    * 
@@ -69,11 +76,10 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The maximum inbound bandwidth from the Internet. Unit: Mbit/s. Valid values:
-   * 
-   * - If the purchased outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of this parameter are 1 to 10 and the default value is 10.
+   * The maximum inbound public bandwidth. Unit: Mbit/s (Megabit per second). Valid values:
    * 
-   * - If the purchased outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter are 1 to the `InternetMaxBandwidthOut` value and the default value is the `InternetMaxBandwidthOut` value.
+   * - If the purchased maximum outbound public bandwidth is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.
+   * - If the purchased maximum outbound public bandwidth is greater than 10 Mbit/s: 1 to the value of `InternetMaxBandwidthOut`. Default value: the value of `InternetMaxBandwidthOut`.
    * 
    * @example
    * 10
@@ -81,17 +87,16 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   internetMaxBandwidthIn?: number;
   /**
    * @remarks
-   * The maximum outbound public bandwidth. Unit: Mbit/s. Valid values:
+   * The maximum outbound public bandwidth. Unit: Mbit/s (Megabit per second). Valid values:
    * 
-   * - Valid values when the pay-by-traffic billing method for network usage is used: 0 to 100.
+   * - Pay-by-traffic: 0 to 100.
    * 
-   * - Valid values when the pay-by-bandwidth billing method for network usage is used:
+   * - Pay-by-bandwidth:
+   *   - Subscription instance: 0 to 200.
+   *   - Pay-as-you-go instance: 0 to 100.
    * 
-   *   - Valid values for subscription instances: 0 to 200.
    * 
-   *   - Valid values for pay-as-you-go instances: 0 to 100.
-   * 
-   * > The maximum outbound bandwidth of a single instance is also limited by the **network baseline bandwidth (Gbit/s) and network burst bandwidth (Gbit/s)** of the instance type. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
+   * > The maximum outbound bandwidth per instance is also limited by the **Network Bandwidth Baseline/Burstable (Gbit/s)** metric of the ECS instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
    * 
    * @example
    * 10
@@ -99,13 +104,12 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   internetMaxBandwidthOut?: number;
   /**
    * @remarks
-   * The billing method for network usage. Valid values:
-   * 
-   * - PayByBandwidth
+   * The conversion target for the network billing method. Valid values:
    * 
-   * - PayByTraffic
+   * - PayByBandwidth: pay-by-bandwidth.
+   * - PayByTraffic: pay-by-traffic.
    * 
-   * > When the **pay-by-traffic** billing method for network usage is used, the maximum inbound and outbound bandwidth values are used as the upper limits of bandwidths instead of guaranteed values. In scenarios where demand outstrips resource supplies, these maximum bandwidths may be limited. If you want guaranteed bandwidths for your instance, use the **pay-by-bandwidth** billing method for network usage.
+   * > In **pay-by-traffic** mode, the inbound and outbound bandwidth peaks are both bandwidth upper limits and are not guaranteed as committed service metrics. When resource contention occurs, the bandwidth peaks may be throttled. If your business requires guaranteed bandwidth, use the **pay-by-bandwidth** mode.
    * 
    * @example
    * PayByTraffic
@@ -117,7 +121,7 @@ export class ModifyInstanceNetworkSpecRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The start time of the temporary bandwidth upgrade. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddThh:mmZ format. The time must be in UTC and accurate to **minutes (mm)**.
+   * The start time of the temporary bandwidth upgrade. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in UTC+0 time in the yyyy-MM-ddTHH:mmZ format. The time must be accurate to the **minute** (mm).
    * 
    * @example
    * 2017-12-05T22:40Z