@alicloud/ecs20140526 7.8.5 → 7.9.0

package/src/models/StartTerminalSessionShrinkRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class StartTerminalSessionShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * Ensures the idempotence of the request. Generate a unique parameter value from your client to guarantee uniqueness across different requests. **ClientToken** supports only ASCII characters and must not exceed 64 characters. 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 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
@@ -13,9 +13,9 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   clientToken?: string;
   /**
    * @remarks
-   * The command to run after the session is initiated. The command length cannot exceed 512 characters.
+   * The command to run after the session is initiated. The command can be up to 512 characters in length.
    * 
-   * > If you specify the `CommandLine` parameter, you cannot specify the `PortNumber` or `TargetServer` parameter.
+   * > After you specify `CommandLine`, you cannot specify `PortNumber` or `TargetServer`.
    * 
    * @example
    * ssh root@192.168.0.246
@@ -23,11 +23,9 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   commandLine?: string;
   /**
    * @remarks
-   * The network type of the WebSocket URL required to connect to the instance. Valid values:
-   * 
-   * - Internet (default)
-   * 
-   * - Intranet
+   * The network type of the WebSocket URL required for the remote connection to the instance. Valid values:
+   * - Internet: the Internet. This is the default value.
+   * - Intranet: the internal network.
    * 
    * @example
    * Intranet
@@ -35,12 +33,12 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   connectionType?: string;
   /**
    * @remarks
-   * Session encryption configuration items.
+   * The session encryption configuration.
    */
   encryptionOptionsShrink?: string;
   /**
    * @remarks
-   * The instance IDs.
+   * The instance ID list.
    * 
    * This parameter is required.
    */
@@ -49,8 +47,8 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The password name of the user when using Session Manager on a Windows instance. The length cannot exceed 255 characters.<br>
-   * When you want to use Session Manager on a Windows instance as a non-default user (System), you must pass both Username and this parameter. To reduce the risk of password disclosure, store the plaintext password in the parameter repository of CloudOps Orchestration Service, and pass only the password name here. For more information, see [encrypted parameters](https://help.aliyun.com/document_detail/186828.html).
+   * The name of the password for the user when you use Session Manager on a Windows instance. The name can be up to 255 characters in length.
+   * When you want to use Session Manager on a Windows instance as a non-default user (System), specify both Username and this parameter. To reduce the risk of password leaks, store the plaintext password in the parameter repository of operations management and specify only the password name here. For more information, see [Encryption parameters](https://help.aliyun.com/document_detail/186828.html).
    * 
    * @example
    * axtSecretPassword
@@ -58,9 +56,9 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   passwordName?: string;
   /**
    * @remarks
-   * The port number of the ECS instance. The port is used to forward data. After this parameter is configured, Cloud Assistant Agent forwards data to the specified port. For example, you can set this parameter to 22 for data forwarding over SSH.
+   * The port number of the ECS instance for data forwarding. After this parameter is specified, Cloud Assistant Agent forwards data to the specified port for port forwarding. For example, SSH uses port 22.
    * 
-   * This parameter is empty by default, which indicates that no port is configured to forward data.
+   * Default value: empty, which indicates that no port number is specified for data forwarding.
    * 
    * @example
    * 22
@@ -68,7 +66,7 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   portNumber?: number;
   /**
    * @remarks
-   * The region ID. 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 query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -80,9 +78,9 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The IP address of the instance. You can use the IP address to access the destination service in a virtual private cloud (VPC).
+   * The address of the destination server in the VPC that you want to access through the instance.
    * 
-   * > If this parameter is not empty, `PortNumber` specifies the port number that is used by the managed instance to access the destination service in the VPC.
+   * > If this parameter is not empty, `PortNumber` specifies the port number of the destination server in the VPC that you want to access through the managed instance.
    * 
    * @example
    * 192.168.0.246
@@ -90,7 +88,7 @@ export class StartTerminalSessionShrinkRequest extends $dara.Model {
   targetServer?: string;
   /**
    * @remarks
-   * The username used for connection establishment.
+   * The username used for the connection.
    * 
    * @example
    * testUser

package/src/models/StopInstanceRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class StopInstanceRequest extends $dara.Model {
   /**
    * @remarks
-   * This parameter will be removed in the future and is retained only to ensure compatibility. We recommend that you ignore this parameter.
+   * This parameter will be deprecated soon and is retained only for compatibility purposes. Ignore this parameter when you call this operation.
    * 
    * @example
    * true
@@ -13,11 +13,10 @@ export class StopInstanceRequest extends $dara.Model {
   confirmStop?: boolean;
   /**
    * @remarks
-   * Specifies whether to perform only a dry run, without performing the actual request. Valid values:
+   * Specifies whether to perform only a dry run. Valid values:
    * 
-   * - true: performs only a dry run. The system checks the request for potential issues, including missing parameter values, incorrect request syntax, service limits, and available ECS resources. If the request fails the dry run, an error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned.
-   * 
-   * - false: performs a dry run and performs the actual request.
+   * - true: performs only a dry run. The instance is not stopped. The system checks whether required parameters are specified, whether the request format is valid, whether business restrictions are met, and whether ECS inventory is sufficient. If the check fails, the corresponding error is returned. If the check succeeds, the `DryRunOperation` error code is returned.
+   * - false: performs a dry run and sends the request. The instance is stopped after the check succeeds.
    * 
    * Default value: false.
    * 
@@ -27,11 +26,10 @@ export class StopInstanceRequest extends $dara.Model {
   dryRun?: boolean;
   /**
    * @remarks
-   * Specifies whether to forcefully stop the ECS instance. Valid values:
-   * 
-   * - true: forcefully stops the ECS instance. If you set ForceStop to true, this operation is equivalent to a power-off operation. Cache data that is not written to storage devices on the instance is lost.
+   * Specifies whether to forcefully stop the instance. Valid values:
    * 
-   * - false: normally stops the ECS instance.
+   * - true: forcefully stops the instance. This is equivalent to a power-off operation. All cached data that is not written to storage devices is lost.
+   * - false: normally stops the instance.
    * 
    * Default value: false.
    * 
@@ -41,7 +39,7 @@ export class StopInstanceRequest extends $dara.Model {
   forceStop?: boolean;
   /**
    * @remarks
-   * > This parameter is in invitational preview and is not publicly available.
+   * > This parameter is in invitational preview and is not available for use.
    * 
    * @example
    * hide
@@ -49,7 +47,7 @@ export class StopInstanceRequest extends $dara.Model {
   hibernate?: boolean;
   /**
    * @remarks
-   * The ID of the instance.
+   * The instance ID.
    * 
    * This parameter is required.
    * 
@@ -63,27 +61,22 @@ export class StopInstanceRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The stop mode of the pay-as-you-go instance. Valid values:
-   * 
-   * - StopCharging: economical mode. After an instance is stopped in economical mode:
-   * 
-   *   - Billing for the following resources of the instance stops: computing resources (vCPUs, memory, and GPUs), image licenses, and public bandwidth of the static public IP address (if any) that uses the pay-by-bandwidth metering method.
-   * 
-   *   - Billing for the following resources of the instance continues: system disk, data disks, and public bandwidth of the elastic IP address (EIP) (if any) that uses the pay-by-bandwidth metering method.
-   * 
-   *   - The instance may fail to restart due to the reclaimed computing resources or insufficient resources. Try again later or change the instance type of the instance.
-   * 
-   *   - If an EIP is associated with the instance before the instance is stopped, the EIP remains unchanged after the instance is restarted. If a static public IP address is associated with the instance before the instance is stopped, the static public IP address may change, but the private IP address does not change.
-   * 
-   *   For more information, see [Economical mode](https://help.aliyun.com/document_detail/63353.html).
+   * The stop mode for the pay-as-you-go ECS instance. Valid values:
    * 
-   *   \\*\\*
+   *   - StopCharging: economical mode. After the economical mode is enabled:
+   *     - Billing is suspended for compute resources (vCPUs, memory, and GPUs), image license fees, and fixed bandwidth of static public IP addresses.
+   *     - Billing continues for system disks, data disks, and fixed bandwidth of Elastic IP Addresses (EIPs).
+   *     - Because compute resources are released, the instance may fail to restart due to insufficient inventory. Try again later or change the instance type.
+   *     - If the instance is associated with an EIP before it is stopped, the IP address remains unchanged after the instance is restarted. Otherwise, the static public IP address may change, but the private IP address remains unchanged. 
    * 
-   *   **Note** If the instance does not support the economical mode, the system stops the instance and does not report errors during the operation call. The following types of instances are not supported: classic network instances, local disks, and monthly instances.
+   *     For more information, see [Economical mode](https://help.aliyun.com/document_detail/63353.html).
+   *     >Notice: 
+   * If the instance does not support the economical mode, no error is returned on the API side. Stopping the instance takes priority. Instance types that do not support the economical mode include instances with local disks and subscription instances.
+   *     
    * 
-   * - KeepCharging: standard mode. After the instance is stopped in standard mode, you continue to be charged for the instance.
+   *   - KeepCharging: standard stop mode. The instance continues to be billed after it is stopped.
    * 
-   * Default value: If the conditions for [enabling the economical mode for an instance in a VPC](~~63353#default~~) are met and you have enabled this mode in the ECS console, the default value is `StopCharging`. Otherwise, the default value is `KeepCharging`.
+   * Default value: If you enable the economical mode for VPC-connected instances in the ECS console (for more information, see [Enable the economical mode by default](~~63353#default~~)) and the conditions are met, the default value is `StopCharging`. Otherwise, the default value is `KeepCharging`.
    * 
    * @example
    * KeepCharging

package/src/models/StopInstancesRequest.ts

@@ -5,11 +5,11 @@ import * as $dara from '@darabonba/typescript';
 export class StopInstancesRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies the batch operation mode. Valid values:
+   * The batch operation mode. Valid values:
    * 
-   * - AllTogether: The batch operation is successful only after all operations are successful. If any operation fails, the batch operation is considered failed, and all operations that have been performed are undone to restore the instances to the status before the batch operation.
+   * - AllTogether: All operations must succeed for the entire batch operation to be considered successful. If any operation fails, the entire batch operation fails and all completed operations are rolled back to the previous state.
    * 
-   * - SuccessFirst: allows each operation in a batch to be independently executed. If an operation fails, other operations can continue and confirm success. In this mode, successful operations are committed and failed operations are marked as failed, but the execution results of other operations are not affected.
+   * - SuccessFirst: Each operation in the batch is executed independently. If an operation fails, other operations can still be executed and confirmed as successful. Successful operations are committed, and failed operations are marked as failed without affecting the results of other operations.
    * 
    * Default value: AllTogether.
    * 
@@ -19,13 +19,12 @@ export class StopInstancesRequest extends $dara.Model {
   batchOptimization?: string;
   /**
    * @remarks
-   * Specifies whether to send a precheck request. Valid values:
+   * Specifies whether to send a dry run request. Valid values:
    * 
-   * - true: performs only a dry run. The system checks the request for potential issues, including missing parameter values, incorrect request syntax, and instance status. If the check fails, the corresponding error message is returned. If the request passes the dry run, `DRYRUN.SUCCESS` is returned.
+   * - true: sends a dry run request without stopping the instances. The system checks the required parameters, request format, and instance status. If the check fails, the corresponding error is returned. If the check succeeds, `DRYRUN.SUCCESS` is returned.
+   * > If the BatchOptimization parameter is set to `SuccessFirst`, the dry run result for `DryRun=true` returns only `DRYRUN.SUCCESS`.
    * 
-   * > If you set `BatchOptimization` to `SuccessFirst` and `DryRun` to true, only `DRYRUN.SUCCESS` is returned, regardless of whether the request passes the dry run.
-   * 
-   * - false: performs a dry run and performs the actual request. If the request passes the dry run, instances are stopped.
+   * - false: sends a normal request. After the request passes the check, the instances are stopped.
    * 
    * Default value: false.
    * 
@@ -35,15 +34,11 @@ export class StopInstancesRequest extends $dara.Model {
   dryRun?: boolean;
   /**
    * @remarks
-   * Specifies whether to forcefully stop instances. Valid values:
-   * 
-   * - true: forcefully stops the ECS instance.
-   * 
-   *   \\*\\*
+   * Specifies whether to forcefully stop the instances. Valid values:
    * 
-   *   **Alert** Force Stop: forcefully stops the instance. A force stop is equivalent to a physical shutdown and may cause data loss if instance data has not been written to disks.
-   * 
-   * - false: normally stops the ECS instance.
+   * - true: forcefully stops the instances.
+   *   >Warning: A forced stop is equivalent to a power-off. Data that is not written to disks in the instance operating system may be lost. Proceed with caution.
+   * - false: normally stops the instances.
    * 
    * Default value: false.
    * 
@@ -53,7 +48,7 @@ export class StopInstancesRequest extends $dara.Model {
   forceStop?: boolean;
   /**
    * @remarks
-   * The IDs of ECS instances. You can specify 1 to 100 instance IDs.
+   * The instance IDs. Array length: 1 to 100.
    * 
    * This parameter is required.
    * 
@@ -65,7 +60,7 @@ export class StopInstancesRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @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 instances. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -77,27 +72,21 @@ export class StopInstancesRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * Stop mode. Valid values:
-   * 
-   * - StopCharging: economical mode. After an instance is stopped in economical mode:
-   * 
-   *   - Billing for the following resources of the instance stops: computing resources (vCPUs, memory, and GPUs), image licenses, and public bandwidth of the static public IP address (if any) that uses the pay-by-bandwidth metering method.
-   * 
-   *   - Billing for the following resources of the instance continues: system disk, data disks, and public bandwidth of the elastic IP address (EIP) (if any) that uses the pay-by-bandwidth metering method.
-   * 
-   *   - The instance may fail to restart due to the reclaimed computing resources or insufficient resources. Try again later or change the instance type of the instance.
-   * 
-   *   - If an EIP is associated with the instance before the instance is stopped, the EIP remains unchanged after the instance is restarted. If a static public IP address is associated with the instance before the instance is stopped, the static public IP address may change, but the private IP address does not change.
-   * 
-   *   For more information, see [Economical mode](https://help.aliyun.com/document_detail/63353.html).
-   * 
-   *   \\*\\*
+   * The stop mode. Valid values:
+   *   - StopCharging: economical mode. After economical mode is enabled:
+   *     - Billing for compute resources (vCPUs, memory, and GPUs), image license fees, and fixed bandwidth of static public IP addresses is suspended.
+   *     - Billing for system disks, data disks, and fixed bandwidth of Elastic IP Addresses (EIPs) continues.
+   *     - Because compute resources are released, the instance may fail to start due to insufficient resources. Try again later or change the instance type.
+   *     - If an EIP is associated with the instance before it is stopped, the IP address remains unchanged after the instance is restarted. Otherwise, the static public IP address may change, but the private IP address remains unchanged. 
    * 
-   *   **Note** If the instance itself does not support the economical shutdown mode, the API side does not intercept errors, and the instance is preferentially stopped. The following types of instances are not supported: classic network instances, local disks, and monthly instances.
+   *     For more information, see [Economical mode](https://help.aliyun.com/document_detail/63353.html).
+   *     >Notice: 
+   * If the instance does not support economical mode, the API does not return an error. Stopping the instance takes priority. Instance types that do not support economical mode include instances with local SSDs and subscription instances.
+   *     
    * 
-   * - KeepCharging: standard mode. After the instance is stopped in standard mode, you continue to be charged for the instance. If you want to change the operating system, re-initialize disks, change the instance type, or modify the private IP address, we recommend selecting this mode to avoid startup failures.
+   *   - KeepCharging: standard stop mode. After the instance is stopped, resources are retained and billing continues. The instance type inventory and public IP address are also retained. If you stop the instance to replace the operating system, reinitialize a disk, change the instance type, or modify the private IP address, select this mode to avoid startup failures.
    * 
-   * Default value: If the conditions for [enabling the economical mode for an instance in a VPC](~~63353#default~~) are met and you have enabled this mode in the ECS console, the default value is `StopCharging`. Otherwise, the default value is `KeepCharging`.
+   * Default value: If you [enable economical mode for VPC-connected instances](~~63353#default~~) and the conditions are met, the default value is `StopCharging`. Otherwise, the default value is `KeepCharging`.
    * 
    * @example
    * KeepCharging

package/src/models/TerminatePhysicalConnectionRequest.ts

@@ -3,34 +3,21 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class TerminatePhysicalConnectionRequest extends $dara.Model {
-  /**
-   * @remarks
-   * A client-generated token to ensure the idempotency of the request. The token must be unique across requests and can contain only ASCII characters, with a maximum length of 64 characters.
-   */
   clientToken?: string;
   ownerAccount?: string;
   ownerId?: number;
   /**
    * @remarks
-   * The ID of the physical connection.
-   * 
    * This parameter is required.
    */
   physicalConnectionId?: string;
   /**
    * @remarks
-   * The ID of the region where the physical connection is deployed.\\
-   * You can call the `DescribeRegions` operation to get the most recent region list.\\
-   * 
    * This parameter is required.
    */
   regionId?: string;
   resourceOwnerAccount?: string;
   resourceOwnerId?: number;
-  /**
-   * @remarks
-   * This parameter is not used.
-   */
   userCidr?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/TerminatePhysicalConnectionResponseBody.ts

@@ -3,10 +3,6 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class TerminatePhysicalConnectionResponseBody extends $dara.Model {
-  /**
-   * @remarks
-   * The request ID.
-   */
   requestId?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/UnassignIpv6addressesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UnassignIpv6AddressesRequest extends $dara.Model {
   /**
    * @remarks
-   * IPv6 address N to unassign. Valid values of N: 1 to 10.
+   * One or more IPv6 addresses to unassign. Valid values of N: 1 to 10.
    * 
    * @example
    * 2001:db8:1234:1a00::***
@@ -13,12 +13,12 @@ export class UnassignIpv6AddressesRequest extends $dara.Model {
   ipv6Address?: string[];
   /**
    * @remarks
-   * IPv6 prefix N to unassign. Valid values of N: 1 to 10.
+   * One or more IPv6 prefixes to unassign. Valid values of N: 1 to 10.
    */
   ipv6Prefix?: string[];
   /**
    * @remarks
-   * The ID of the ENI.
+   * The ID of the network interface controller (NIC).
    * 
    * This parameter is required.
    * 
@@ -30,7 +30,7 @@ export class UnassignIpv6AddressesRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The region ID of the ENI. 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 network interface controller (NIC). You can invoke [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 

package/src/models/UnassignIpv6addressesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UnassignIpv6AddressesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

package/src/models/model.ts

@@ -293,6 +293,7 @@ export { DescribeDisksRequestFilter } from './DescribeDisksRequest';
 export { DescribeDisksRequestTag } from './DescribeDisksRequest';
 export { DescribeDisksResponseBodyDisksDiskAttachmentsAttachment } from './DescribeDisksResponseBody';
 export { DescribeDisksResponseBodyDisksDiskAttachments } from './DescribeDisksResponseBody';
+export { DescribeDisksResponseBodyDisksDiskDataSource } from './DescribeDisksResponseBody';
 export { DescribeDisksResponseBodyDisksDiskMountInstancesMountInstance } from './DescribeDisksResponseBody';
 export { DescribeDisksResponseBodyDisksDiskMountInstances } from './DescribeDisksResponseBody';
 export { DescribeDisksResponseBodyDisksDiskOperationLocksOperationLock } from './DescribeDisksResponseBody';
@@ -450,6 +451,7 @@ export { DescribeInstanceRamRoleResponseBodyInstanceRamRoleSetsInstanceRamRoleSe
 export { DescribeInstanceRamRoleResponseBodyInstanceRamRoleSets } from './DescribeInstanceRamRoleResponseBody';
 export { DescribeInstanceStatusResponseBodyInstanceStatusesInstanceStatus } from './DescribeInstanceStatusResponseBody';
 export { DescribeInstanceStatusResponseBodyInstanceStatuses } from './DescribeInstanceStatusResponseBody';
+export { DescribeInstanceTopologyResponseBodyTopologysTopologyNetworkNodes } from './DescribeInstanceTopologyResponseBody';
 export { DescribeInstanceTopologyResponseBodyTopologysTopology } from './DescribeInstanceTopologyResponseBody';
 export { DescribeInstanceTopologyResponseBodyTopologys } from './DescribeInstanceTopologyResponseBody';
 export { DescribeInstanceTypeFamiliesResponseBodyInstanceTypeFamiliesInstanceTypeFamily } from './DescribeInstanceTypeFamiliesResponseBody';
@@ -1903,6 +1905,9 @@ export { ModifyStorageCapacityUnitAttributeResponse } from './ModifyStorageCapac
 export { ModifyStorageSetAttributeRequest } from './ModifyStorageSetAttributeRequest';
 export { ModifyStorageSetAttributeResponseBody } from './ModifyStorageSetAttributeResponseBody';
 export { ModifyStorageSetAttributeResponse } from './ModifyStorageSetAttributeResponse';
+export { ModifySystemEventAttributeRequest } from './ModifySystemEventAttributeRequest';
+export { ModifySystemEventAttributeResponseBody } from './ModifySystemEventAttributeResponseBody';
+export { ModifySystemEventAttributeResponse } from './ModifySystemEventAttributeResponse';
 export { ModifyUserBusinessBehaviorRequest } from './ModifyUserBusinessBehaviorRequest';
 export { ModifyUserBusinessBehaviorResponseBody } from './ModifyUserBusinessBehaviorResponseBody';
 export { ModifyUserBusinessBehaviorResponse } from './ModifyUserBusinessBehaviorResponse';