@alicloud/ecs20140526 7.8.4 → 7.8.5

package/src/models/CloneDisksRequest.ts

@@ -4,16 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class CloneDisksRequestArn extends $dara.Model {
   /**
+   * @remarks
+   * > This parameter is not yet available.
+   * 
    * @example
    * null
    */
   assumeRoleFor?: string;
   /**
+   * @remarks
+   * > This parameter is not yet available.
+   * 
    * @example
    * null
    */
   roleType?: string;
   /**
+   * @remarks
+   * > This parameter is not yet available.
+   * 
    * @example
    * null
    */
@@ -45,11 +54,17 @@ export class CloneDisksRequestArn extends $dara.Model {
 
 export class CloneDisksRequestTag extends $dara.Model {
   /**
+   * @remarks
+   * The key of tag N to add to the new disk. Valid values of N: 1 to 20. The tag key must be 1 to 128 characters in length and cannot start with `aliyun` or `acs:` or contain `http://` or `https://`.
+   * 
    * @example
    * TestKey
    */
   key?: string;
   /**
+   * @remarks
+   * The value of tag N to add to the new disk. Valid values of N: 1 to 20. The tag value can be an empty string or up to 128 characters in length, and it cannot contain `http://` or `https://`.
+   * 
    * @example
    * TestValue
    */
@@ -78,19 +93,51 @@ export class CloneDisksRequestTag extends $dara.Model {
 }
 
 export class CloneDisksRequest extends $dara.Model {
+  /**
+   * @remarks
+   * > This parameter is not yet available.
+   */
   arn?: CloneDisksRequestArn[];
   /**
+   * @remarks
+   * Specifies whether to enable performance bursting for the new disk. Valid values:
+   * 
+   * - `true`: Enables performance bursting.
+   * 
+   * - `false`: Disables performance bursting.
+   * 
+   * > This parameter is valid only when `DiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL cloud disks](https://help.aliyun.com/zh/ecs/user-guide/essd-autopl-disks).
+   * 
    * @example
    * true
    */
   burstingEnabled?: boolean;
   /**
+   * @remarks
+   * A client-generated token that, when provided, ensures the idempotence of the request. The token must be unique for each request. 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).
+   * 
    * @example
    * 123e4567-e89b-12d3-a456-426655440000
    */
   clientToken?: string;
   /**
    * @remarks
+   * The type of the new disk. Valid values:
+   * 
+   * - `cloud_essd`: ESSD cloud disk.
+   * 
+   * - `cloud_auto`: ESSD AutoPL cloud disk.
+   * 
+   * - `cloud_essd_entry`: ESSD Entry cloud disk.
+   * 
+   * - `cloud_regional_disk_auto`: regional disk.
+   * 
+   * > Disk type limits for cloning
+   * >
+   * > - A non-regional disk can be cloned only as a non-regional disk.
+   * >
+   * > - A regional disk can be cloned only as a regional disk.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -98,27 +145,57 @@ export class CloneDisksRequest extends $dara.Model {
    */
   diskCategory?: string;
   /**
+   * @remarks
+   * The name of the new disk. The name must be 2 to 128 characters in length. It must start with a letter and can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
+   * 
+   * Default value: none.
+   * 
    * @example
    * MyDiskName
    */
   diskName?: string;
   /**
+   * @remarks
+   * Specifies whether to perform a dry run. Valid values:
+   * 
+   * - `true`: Performs a dry run to check the request without cloning the disk. The system checks whether your AccessKey is valid, whether the RAM user is authorized, and whether the required parameters are specified. If the request fails the check, the system returns the corresponding error message. If the request passes the check, the `DryRunOperation` error code is returned.
+   * 
+   * - `false` (default): Sends a normal request. If the request passes the check, the system returns a 2xx HTTP status code and clones the disk.
+   * 
    * @example
    * true
    */
   dryRun?: string;
   /**
+   * @remarks
+   * Specifies whether to encrypt the new disk. Valid values:
+   * 
+   * - `true`: The disk is encrypted.
+   * 
+   * - `false`: The disk is not encrypted.
+   * 
+   * Default value: false.
+   * 
    * @example
    * false
    */
   encrypted?: boolean;
   /**
+   * @remarks
+   * The ID of the KMS key to use for the new disk.
+   * 
    * @example
    * key-szz67b2f696f4wh9yeg5d
    */
   kmsKeyId?: string;
   /**
    * @remarks
+   * Specifies whether to enable the multi-attach feature for the new disk. Valid values:
+   * 
+   * - `Disabled`: Disables the multi-attach feature.
+   * 
+   * - `Enabled`: Enables the multi-attach feature. You can set this parameter to `Enabled` only for ESSD cloud disks.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -127,17 +204,45 @@ export class CloneDisksRequest extends $dara.Model {
   multiAttach?: string;
   ownerId?: number;
   /**
+   * @remarks
+   * The performance level of the new ESSD cloud disk. Valid values:
+   * 
+   * - `PL0`: A single disk can deliver up to 10,000 random read/write IOPS.
+   * 
+   * - `PL1`: A single disk can deliver up to 50,000 random read/write IOPS.
+   * 
+   * - `PL2`: A single disk can deliver up to 100,000 random read/write IOPS.
+   * 
+   * - `PL3`: A single disk can deliver up to 1,000,000 random read/write IOPS.
+   * 
+   * > This parameter is required when `DiskCategory` is set to `cloud_essd`.
+   * 
+   * For more information about how to select an ESSD performance level, see [ESSD cloud disks](https://help.aliyun.com/document_detail/122389.html).
+   * 
    * @example
    * PL1
    */
   performanceLevel?: string;
   /**
+   * @remarks
+   * The provisioned read/write IOPS of the ESSD AutoPL cloud disk. Valid values:
+   * 
+   * - You cannot set this parameter for disks that are 3 GiB or smaller in size.
+   * 
+   * - For disks that are 4 GiB or larger in size, the value must be in the range of `[0, min(1000 * Size - baseline performance, 50000)]`.
+   * 
+   * baseline performance = `max(min(1800 + 50 * Size, 50000), 3000)`.
+   * 
+   * > This parameter is valid only when `DiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL cloud disks](https://help.aliyun.com/zh/ecs/user-guide/essd-autopl-disks).
+   * 
    * @example
    * 10
    */
   provisionedIops?: number;
   /**
    * @remarks
+   * The ID of the region. You can call the [DescribeRegions](https://help.aliyun.com/zh/ecs/api-regions-describeregions) operation to view the latest list of Alibaba Cloud regions.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -145,6 +250,9 @@ export class CloneDisksRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The ID of the resource group for the new disk.
+   * 
    * @example
    * rg-bp199lyny9b3****
    */
@@ -152,6 +260,24 @@ export class CloneDisksRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
+   * The size of the new disk, in GiB. The value must be greater than or equal to the size of the source disk. The value range varies based on the `DiskCategory` value:
+   * 
+   * - `cloud_essd`: The value range depends on the `PerformanceLevel` value.
+   * 
+   *   - `PL0`: 1 to 65,536
+   * 
+   *   - `PL1`: 20 to 65,536
+   * 
+   *   - `PL2`: 461 to 65,536
+   * 
+   *   - `PL3`: 1,261 to 65,536
+   * 
+   * - `cloud_auto`: 1 to 65,536
+   * 
+   * - `cloud_essd_entry`: 10 to 32,768
+   * 
+   * - `cloud_regional_disk_auto`: 10 to 65,536
+   * 
    * This parameter is required.
    * 
    * @example
@@ -160,12 +286,18 @@ export class CloneDisksRequest extends $dara.Model {
   size?: number;
   /**
    * @remarks
+   * The ID of the source disk.
+   * 
    * This parameter is required.
    * 
    * @example
    * d-bp1d6tsvznfghy7y****
    */
   sourceDiskId?: string;
+  /**
+   * @remarks
+   * The tags to add to the new disk.
+   */
   tag?: CloneDisksRequestTag[];
   static names(): { [key: string]: string } {
     return {

package/src/models/CloneDisksResponseBody.ts

@@ -4,11 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class CloneDisksResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The ID of the request.
+   * 
    * @example
    * 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    */
   requestId?: string;
   /**
+   * @remarks
+   * The ID of the disk clone task group. You can call the [DescribeTasks](https://help.aliyun.com/zh/ecs/developer-reference/api-ecs-2014-05-26-describetasks) operation to query the execution result.
+   * 
    * @example
    * g-2ze2op2grqpclwu7****
    */

package/src/models/ConnectRouterInterfaceRequest.ts

@@ -6,6 +6,8 @@ export class ConnectRouterInterfaceRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
+   * The ID of the region where the router interface is located.
+   * 
    * This parameter is required.
    */
   regionId?: string;
@@ -13,6 +15,8 @@ export class ConnectRouterInterfaceRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
+   * The ID of the initiator router interface.
+   * 
    * This parameter is required.
    */
   routerInterfaceId?: string;

package/src/models/ConnectRouterInterfaceResponseBody.ts

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

package/src/models/CopyImageRequest.ts

@@ -79,8 +79,9 @@ export class CopyImageRequest extends $dara.Model {
    * @remarks
    * Specifies whether to perform only a dry run, without performing the actual request. Specifies whether to check the image used by the instance supports hot migration. Valid values:
    * 
-   * *   true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized RAM users, and missing parameter values. 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. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.
+   * - true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized RAM users, and missing parameter values. 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. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.
    * 
    * Default value: false.
    * 
@@ -100,8 +101,9 @@ export class CopyImageRequest extends $dara.Model {
    * @remarks
    * Specifies whether to encrypt the new image.
    * 
-   * *   true
-   * *   false
+   * - true
+   * 
+   * - false
    * 
    * Default value: false.
    * 
@@ -143,7 +145,7 @@ export class CopyImageRequest extends $dara.Model {
    * @remarks
    * The ID of the resource group to which to assign the new image. If you do not specify this parameter, the new image is assigned to the default resource group.
    * 
-   * >  If you call the CopyImage operation as a Resource Access Management (RAM) user who does not have the permissions to manage the default resource group and do not specify `ResourceGroupId`, the `Forbidden: User not authorized to operate on the specified resource` error message is returned. You must specify the ID of a resource group that the RAM user has the permissions to manage or grant the RAM user the permissions to manage the default resource group before you call the CopyImage operation again.
+   * > If you call the CopyImage operation as a Resource Access Management (RAM) user who does not have the permissions to manage the default resource group and do not specify `ResourceGroupId`, the `Forbidden: User not authorized to operate on the specified resource` error message is returned. You must specify the ID of a resource group that the RAM user has the permissions to manage or grant the RAM user the permissions to manage the default resource group before you call the CopyImage operation again.
    * 
    * @example
    * rg-bp67acfmxazb4p****

package/src/models/CopySnapshotRequest.ts

@@ -55,7 +55,7 @@ export class CopySnapshotRequestArn extends $dara.Model {
 export class CopySnapshotRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N to add to the new snapshot. The tag key cannot be an empty string. It can be up to 128 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.
+   * The key of tag N to add to the new snapshot. The tag key cannot be an empty string. It can be up to 128 characters in length and cannot start with acs: or aliyun. It cannot contain http\\:// or https\\://.
    * 
    * @example
    * TestKey
@@ -63,7 +63,7 @@ export class CopySnapshotRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N to add to the new snapshot. The tag value can be an empty string. It can be up to 128 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.
+   * The value of tag N to add to the new snapshot. The tag value can be an empty string. It can be up to 128 characters in length and cannot start with acs: or aliyun. It cannot contain http\\:// or https\\://.
    * 
    * @example
    * TestValue
@@ -95,7 +95,7 @@ export class CopySnapshotRequestTag extends $dara.Model {
 export class CopySnapshotRequest extends $dara.Model {
   /**
    * @remarks
-   * >This parameter is currently in invitational preview and unavailable for public use.
+   * > This parameter is currently in invitational preview and unavailable for public use.
    */
   arn?: CopySnapshotRequestArn[];
   /**
@@ -118,7 +118,7 @@ export class CopySnapshotRequest extends $dara.Model {
   destinationRegionId?: string;
   /**
    * @remarks
-   * The description of the new snapshot. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
+   * The description of the new snapshot. The description must be 2 to 256 characters in length and cannot start with http\\:// or https\\://.
    * 
    * This parameter is empty by default.
    * 
@@ -130,7 +130,7 @@ export class CopySnapshotRequest extends $dara.Model {
   destinationSnapshotDescription?: string;
   /**
    * @remarks
-   * The name of the new snapshot. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
+   * The name of the new snapshot. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http\\:// or https\\://. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
    * 
    * This parameter is left empty by default.
    * 
@@ -142,7 +142,7 @@ export class CopySnapshotRequest extends $dara.Model {
   destinationSnapshotName?: string;
   /**
    * @remarks
-   * >  This parameter is not publicly available.
+   * > This parameter is not publicly available.
    * 
    * @example
    * null
@@ -152,8 +152,9 @@ export class CopySnapshotRequest extends $dara.Model {
    * @remarks
    * Specifies whether to encrypt the new snapshot. Valid values:
    * 
-   * *   true
-   * *   false
+   * - true
+   * 
+   * - false
    * 
    * Default value: false.
    * 

package/src/models/CreateActivationRequest.ts

@@ -49,6 +49,13 @@ export class CreateActivationRequestTag extends $dara.Model {
 }
 
 export class CreateActivationRequest extends $dara.Model {
+  /**
+   * @remarks
+   * Ensures the idempotence of the request. Generate a unique value for this parameter from your client to guarantee that the value differs across requests. **ClientToken** supports only ASCII characters and cannot exceed 64 characters. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
+   * 
+   * @example
+   * 123e4567-e89b-12d3-a456-426655440000
+   */
   clientToken?: string;
   /**
    * @remarks