@alicloud/ecs20140526 7.8.6 → 7.9.0

package/src/models/DescribeSecurityGroupsRequest.ts

@@ -7,7 +7,7 @@ export class DescribeSecurityGroupsRequestTag extends $dara.Model {
    * @remarks
    * The tag key of the security group. Valid values of N: 1 to 20.
    * 
-   * When you use a single tag to filter resources, the number of resources with the tag cannot exceed 1000. When you use multiple tags to filter resources, the number of resources bound with all specified tags cannot exceed 1000. If the number of resources exceeds 1000, use the [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation to query.
+   * If you use a single tag to filter resources, the resource count with the specified tag cannot exceed 1,000. If you use multiple tags to filter resources, the resource count that have all specified tags attached cannot exceed 1,000. If the resource count exceeds 1,000, call [ListTagResources](https://help.aliyun.com/document_detail/110425.html) to query resources.
    * 
    * @example
    * TestKey
@@ -47,10 +47,10 @@ export class DescribeSecurityGroupsRequestTag extends $dara.Model {
 export class DescribeSecurityGroupsRequest extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to perform only a dry run, without performing the actual request. Valid values:
-   * 
-   * - true: performs only a dry run. The system checks the request for potential issues, including AccessKey validity, RAM user authorization, and required parameters. 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 performs the actual request. If the check succeeds, a 2XX HTTP status code is returned and the resource status is queried.
+   * 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 invalid AccessKey pairs, unauthorized Resource Access Management (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 sends the Normal request. If the request passes the dry run, a 2xx HTTP status code is returned and the authorization is verified.
    * 
    * Default value: false.
    * 
@@ -68,7 +68,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   fuzzyQuery?: boolean;
   /**
    * @remarks
-   * Specifies whether to query the capacity information of the security group. When set to True, the `EcsCount` and `AvailableInstanceAmount` values in the response are valid.
+   * Specifies whether to query the capacity information of the security group. If you set this parameter to True, the `EcsCount` and `AvailableInstanceAmount` values in the response are valid.
    * > This parameter is deprecated.
    * 
    * @example
@@ -77,7 +77,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   isQueryEcsCount?: boolean;
   /**
    * @remarks
-   * The maximum number of entries per page for a paged query. Once this parameter is set, the query uses the combination of `MaxResults` and `NextToken` parameters.
+   * The maximum number of entries per page for paging query. If you set this parameter, the `MaxResults` and `NextToken` paging method is used.
    * 
    * Maximum value: 100.
    * 
@@ -91,8 +91,8 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
    * @remarks
    * The network type of the security group. Valid values:
    * 
-   * - vpc: Virtual Private Cloud (VPC).
-   * - classic: classic network.
+   * - vpc: VPC.
+   * - classic: classic network. The classic network is deprecated. For more information, see [Deprecation notice](https://help.aliyun.com/document_detail/2833134.html).
    * 
    * @example
    * vpc
@@ -100,7 +100,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   networkType?: string;
   /**
    * @remarks
-   * The query token. Set the value to the NextToken value returned in the previous call to this operation. You do not need to set this parameter for the first call.
+   * The pagination token. Set this parameter to the NextToken value returned in the previous request. You do not need to set this parameter for the first request.
    * 
    * @example
    * e71d8a535bd9cc11
@@ -110,7 +110,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * > This parameter is about to be deprecated. We recommend that you use NextToken and MaxResults for paged queries.
+   * > This parameter will be offline. Use NextToken and MaxResults for paging.
    * 
    * @example
    * 1
@@ -118,7 +118,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * > This parameter is about to be deprecated. We recommend that you use NextToken and MaxResults for paged queries.
+   * > This parameter will be offline. Use NextToken and MaxResults for paging.
    * 
    * @example
    * 10
@@ -126,7 +126,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The region ID. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the latest region list of Alibaba Cloud.
+   * The region ID. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -136,7 +136,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group to which the security group belongs. When you use this parameter to filter resources, the number of resources cannot exceed 1000. You can call [ListResourceGroups](https://help.aliyun.com/document_detail/158855.html) to query the list of resource groups.
+   * The ID of the resource group to which the security group belongs. When you use this parameter to filter resources, the resource count cannot exceed 1,000. You can invoke [ListResourceGroups](https://help.aliyun.com/document_detail/158855.html) to query resource groups.
    * 
    * > Filtering by the default resource group is not supported.
    * 
@@ -156,7 +156,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   securityGroupId?: string;
   /**
    * @remarks
-   * The list of security group IDs. A maximum of 100 security group IDs are supported at a time. The IDs are separated by commas (,) in the format of a JSON array.
+   * The IDs of security groups. You can specify up to 100 security group IDs. Separate multiple IDs with commas (,) in a JSON array format.
    * 
    * @example
    * ["sg-bp67acfmxazb4p****", "sg-bp67acfmxazb4p****", "sg-bp67acfmxazb4p****",....]
@@ -176,7 +176,7 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
    * - normal: basic security group.
    * - enterprise: advanced security group.
    * 
-   * > If you do not specify this parameter, all types of security groups are queried.
+   * > If you do not specify this parameter, security groups of all types are queried.
    * 
    * @example
    * normal
@@ -184,10 +184,10 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   securityGroupType?: string;
   /**
    * @remarks
-   * Specifies whether the security group is managed. Valid values:
+   * Specifies whether managed security group is managed. Valid values:
    * 
-   * - true: The security group is managed.
-   * - false: The security group is not managed.
+   * - true: Managed security group is managed.
+   * - false: Managed security group is not managed.
    * 
    * @example
    * false
@@ -198,12 +198,12 @@ export class DescribeSecurityGroupsRequest extends $dara.Model {
   serviceManaged?: boolean;
   /**
    * @remarks
-   * The list of tags.
+   * The tags.
    */
   tag?: DescribeSecurityGroupsRequestTag[];
   /**
    * @remarks
-   * The ID of the VPC to which the security group belongs.
+   * The ID of the virtual private cloud (VPC) to which the security group belongs.
    * 
    * @example
    * vpc-bp67acfmxazb4p****

package/src/models/DescribeSecurityGroupsResponseBody.ts

@@ -148,7 +148,7 @@ export class DescribeSecurityGroupsResponseBodySecurityGroups extends $dara.Mode
 export class DescribeSecurityGroupsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The query token returned in this call. When you use the MaxResults and NextToken method for paged queries and this return value is empty, no more data is available.
+   * The pagination token returned in this call. If this value is empty when you use MaxResults and NextToken for paging, no more data is available.
    * 
    * @example
    * e71d8a535bd9cc11
@@ -158,7 +158,7 @@ export class DescribeSecurityGroupsResponseBody extends $dara.Model {
    * @remarks
    * The current page number.
    * 
-   * > This parameter is about to be deprecated. We recommend that you use NextToken and MaxResults for paged queries.
+   * > This parameter will be offline. Use NextToken and MaxResults for paging.
    * 
    * @example
    * 1
@@ -168,7 +168,7 @@ export class DescribeSecurityGroupsResponseBody extends $dara.Model {
    * @remarks
    * The number of entries per page.
    * 
-   * > This parameter is about to be deprecated. We recommend that you use NextToken and MaxResults for paged queries.
+   * > This parameter will be offline. Use NextToken and MaxResults for paging.
    * 
    * @example
    * 10
@@ -193,7 +193,7 @@ export class DescribeSecurityGroupsResponseBody extends $dara.Model {
   securityGroups?: DescribeSecurityGroupsResponseBodySecurityGroups;
   /**
    * @remarks
-   * The total number of security groups. This parameter value is not returned when you use the `MaxResults` and `NextToken` parameters for queries.
+   * The total number of security groups. This parameter is not returned when you use `MaxResults` and `NextToken` for parameter query.
    * 
    * @example
    * 20

package/src/models/DescribeSendFileResultsRequest.ts

@@ -5,11 +5,11 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSendFileResultsRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N of the file sending task. Valid values of N: 1 to 20. The tag key cannot be an empty string.
+   * The tag key of the file sending task. Valid values of N: 1 to 20. The tag key cannot be an empty string.
    * 
-   * If a single tag is specified to query resources, up to 1,000 resources that have this tag added can be displayed in the response. If multiple tags are specified to query resources, up to 1,000 resources that have all the tags added can be displayed in the response. To query more than 1,000 resources that have specified tags, call the [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation.
+   * If you use a single tag to filter resources, the resource count with the specified tag cannot exceed 1000. If you use multiple tags to filter resources, the resource count of resources that attach all specified tags cannot exceed 1000. If the resource count exceeds 1000, call the [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation.
    * 
-   * The tag key can be up to 64 characters in length and cannot contain `http://` or `https://`. The tag key cannot start with `acs:` or `aliyun`.
+   * The tag key can be up to 64 characters in length and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.
    * 
    * @example
    * TestKey
@@ -17,7 +17,7 @@ export class DescribeSendFileResultsRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N of the file sending task. Valid values of N: 1 to 20. The tag value can be an empty string.
+   * The tag value of the file sending task. Valid values of N: 1 to 20. The tag value can be an empty string.
    * 
    * The tag value can be up to 128 characters in length and cannot contain `http://` or `https://`.
    * 
@@ -51,7 +51,7 @@ export class DescribeSendFileResultsRequestTag extends $dara.Model {
 export class DescribeSendFileResultsRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the instance for which you want to query file sending records.
+   * The instance ID. If you specify this parameter, all file sending records of the specified instance are queried.
    * 
    * @example
    * i-hz0jdfwd9f****
@@ -59,17 +59,13 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The overall sending status of the file. The overall sending status of the file varies based on the sending status of the file on all destination instances. Valid values:
+   * The overall sending status of the file. The overall status depends on the combined execution status of all instances in the sending task. Valid values:
    * 
-   * - Pending: The file is being verified or sent. If the sending state of the file on at least one instance is Pending, the overall sending state of the file is Pending.
-   * 
-   * - Running: The file is being sent to the instances. If the sending state of the file on at least one instance is Running, the overall sending state of the file is Running.
-   * 
-   * - Success: The file is sent. If the sending state of the file on all instances is Success, the overall sending state of the file is Success.
-   * 
-   * - Failed: The file fails to be sent. If the sending state of the file on all instances is Failed, the overall sending state of the file is Failed.
-   * 
-   * - PartialFailed: The file sending task succeeds on some instances and fails on other instances. If the sending state of the file is Success on some instances and is Failed on other instances, the overall sending state of the file is PartialFailed.
+   * - Pending: The system is validating or sending the file. The overall status is Pending if the file sending status of at least one instance is Pending.
+   * - Running: The file is being sent to instances. The overall status is Running if the file sending status of at least one instance is Running.
+   * - Success: The file is sent. The overall status is Success if the file sending status of all instances is Success.
+   * - Failed: The file failed to be sent. The overall status is Failed if the file sending status of all instances is Failed.
+   * - PartialFailed: The file is sent to some instances but failed on others. The overall status is PartialFailed if the file sending status of all instances is Success or Failed.
    * 
    * @example
    * Success
@@ -77,7 +73,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   invocationStatus?: string;
   /**
    * @remarks
-   * The ID of the file sending task.
+   * The execution ID.
    * 
    * @example
    * f-hz0jdfwd9f****
@@ -85,9 +81,9 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   invokeId?: string;
   /**
    * @remarks
-   * The maximum number of entries per page.
+   * The maximum number of entries per page for a paged query.
    * 
-   * Valid values: 1 to 50.
+   * Maximum value: 50.
    * 
    * Default value: 10.
    * 
@@ -97,7 +93,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The name of the file whose sending records you want to query.
+   * The name of the file. If you specify this parameter, all sending records of the file with the specified name are queried.
    * 
    * @example
    * test.txt
@@ -105,7 +101,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The pagination token that is used in the next request to retrieve a new page of results. You must specify the token that is obtained from the previous query as the value of NextToken.
+   * The pagination token. Set this parameter to the NextToken value returned in the previous API call.
    * 
    * @example
    * AAAAAdDWBF2
@@ -115,7 +111,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * > This parameter will be removed in the future. We recommend that you use NextToken and MaxResults for a paged query.
+   * > This parameter is about to be deprecated. Use NextToken and MaxResults to complete paging operations.
    * 
    * @example
    * 1
@@ -123,7 +119,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * > This parameter will be removed in the future. We recommend that you use NextToken and MaxResults for a paged query.
+   * > This parameter is about to be deprecated. Use NextToken and MaxResults to complete paging operations.
    * 
    * @example
    * 10
@@ -131,7 +127,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The region ID of the ECS 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 ECS instance. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -141,7 +137,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group. After you set this parameter, file sending results in the specified resource group are queried.
+   * The ID of the resource group to which the file sending task belongs. After you specify this parameter, you must also specify ResourceGroupId when sending the file. This parameter allows you to filter file sending results by resource group.
    * 
    * @example
    * rg-bp67acfmxazb4p****
@@ -151,7 +147,7 @@ export class DescribeSendFileResultsRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The tags of the file sending task.
+   * The list of tags.
    */
   tag?: DescribeSendFileResultsRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/DescribeSendFileResultsResponseBody.ts

@@ -225,7 +225,7 @@ export class DescribeSendFileResultsResponseBody extends $dara.Model {
   invocations?: DescribeSendFileResultsResponseBodyInvocations;
   /**
    * @remarks
-   * A pagination token. It can be used in the next request to retrieve a new page of results.
+   * The pagination token returned in this call.
    * 
    * @example
    * AAAAAdDWBF2
@@ -233,7 +233,7 @@ export class DescribeSendFileResultsResponseBody extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The page number.
+   * The page number of the query result.
    * 
    * @example
    * 1
@@ -257,7 +257,7 @@ export class DescribeSendFileResultsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of file sending tasks queried.
+   * The total number of scripts.
    * 
    * @example
    * 2

package/src/models/DescribeSnapshotsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSnapshotsRequestFilter extends $dara.Model {
   /**
    * @remarks
-   * The filter key for querying resources. The value must be `CreationStartTime`. If you specify `Filter.1.Key` and `Filter.1.Value`, you can query for resources that were created after the specified point in time.
+   * The filter key used to query resources. Set the value to `CreationStartTime`. When you specify both `Filter.1.Key` and `Filter.1.Value`, you can query resources created after the specified point in time.
    * 
    * @example
    * CreationStartTime
@@ -13,7 +13,7 @@ export class DescribeSnapshotsRequestFilter extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The filter value. If you specify this parameter, you must also specify `Filter.1.Key`. The value must be in the `yyyy-MM-ddTHH:mmZ` format and in UTC.
+   * The filter value used to query resources. When you specify this parameter, you must also specify `Filter.1.Key`. Specify the time in the `yyyy-MM-ddTHH:mmZ` format in UTC.
    * 
    * @example
    * 2019-12-13T17:00Z
@@ -45,9 +45,9 @@ export class DescribeSnapshotsRequestFilter extends $dara.Model {
 export class DescribeSnapshotsRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The tag key.
+   * The tag key of the snapshot. Valid values of N: 1 to 20.
    * 
-   * > For better compatibility, use the `Tag.N.Key` parameter.
+   * If you use a single tag to filter resources, the resource count with the specified tag cannot exceed 1000. If you use multiple tags to filter resources, the resource count with all specified tags attached cannot exceed 1000. If the resource count exceeds 1000, call the [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation.
    * 
    * @example
    * TestKey
@@ -55,7 +55,7 @@ export class DescribeSnapshotsRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The tag value.
+   * The tag value of the snapshot. Valid values of N: 1 to 20.
    * 
    * @example
    * TestValue
@@ -89,20 +89,15 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   /**
    * @remarks
    * The category of the snapshot. Valid values:
+   * - Standard: standard snapshot.
+   * - Flash: local snapshot. This value is about to be deprecated. Local snapshots have been replaced by the snapshot instant access feature. The metric description is as follows:
+   *   - If you used local snapshots before December 14, 2020, you can use this parameter. The parameter is active.
+   *   - If you did not use local snapshots before December 14, 2020, you cannot use this parameter.
+   * - archive: archive snapshot.
    * 
-   * - `Standard`: A standard snapshot.
    * 
-   * - `Flash`: A local snapshot. This value is deprecated because the local snapshot feature has been replaced by the instant access feature.
    * 
-   *   - If you have used local snapshots before December 14, 2020, you can continue to use this value.
-   * 
-   *   - If you have not used local snapshots before December 14, 2020, you cannot use this value.
-   * 
-   * - `archive`: An archive snapshot.
-   * 
-   * <props="china">
-   * 
-   * For more information, see [December 14: Alibaba Cloud snapshot service upgrade and new billing items notice](https://help.aliyun.com/noticelist/articleid/1060755542.html).
+   * <props="china">For more information, see [Chinese site notice on snapshot service upgrade and new billing items on December 14](https://help.aliyun.com/noticelist/articleid/1060755542.html).
    * 
    * @example
    * Standard
@@ -110,7 +105,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   category?: string;
   /**
    * @remarks
-   * The ID of the cloud disk.
+   * The ID of the disk.
    * 
    * @example
    * d-bp67acfmxazb4p****
@@ -118,11 +113,10 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   diskId?: string;
   /**
    * @remarks
-   * Specifies whether to perform a dry run.
-   * 
-   * - `true`: Performs a dry run but does not query resources. The system checks the request for potential issues, including missing required parameters, invalid parameter values, and insufficient permissions. If the request is invalid, an error is returned. If the request is valid, the `DryRunOperation` error code is returned.
+   * Specifies whether to perform only a dry run, without performing the actual request.
    * 
-   * - `false` (Default): Sends a normal request. If the request is valid, the system returns a 2xx HTTP status code and the query results.
+   * - 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 (default): performs a dry run and sends the request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.
    * 
    * @example
    * false
@@ -130,7 +124,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   dryRun?: boolean;
   /**
    * @remarks
-   * Specifies whether to return only encrypted snapshots. Default value: false.
+   * Specifies whether to filter encrypted snapshots. Default value: false.
    * 
    * @example
    * false
@@ -138,7 +132,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   encrypted?: boolean;
   /**
    * @remarks
-   * The ID of the instance. When you specify this ID, the operation returns snapshots of cloud disks attached to the instance.
+   * The instance ID. Specify this parameter to query snapshot information of disks attached to the instance.
    * 
    * @example
    * i-bp67acfmxazb4p****
@@ -146,7 +140,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The ID of the KMS key used to encrypt the snapshot.
+   * The ID of the Key Management Service (KMS) key used by the data disk.
    * 
    * @example
    * 0e478b7a-4262-4802-b8cb-00d3fb40****
@@ -154,7 +148,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   KMSKeyId?: string;
   /**
    * @remarks
-   * The number of entries to return on each page. Maximum value: 100.
+   * The maximum number of entries per page for paging. Maximum value: 100.
    * 
    * Default value: 10.
    * 
@@ -164,7 +158,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token to start the next page of results. You can obtain this token from the response to a previous query.
+   * The pagination token. Obtained from the response of the previous request.
    * 
    * @example
    * caeba0bbb2be03f84eb48b699f0a4883
@@ -174,7 +168,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * > This parameter is deprecated. We recommend that you use the `NextToken` and `MaxResults` parameters for paged queries.
+   * > This parameter is about to be deprecated. Use NextToken and MaxResults for paging instead.
    * 
    * @example
    * 1
@@ -182,7 +176,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * > This parameter is deprecated. We recommend that you use the `NextToken` and `MaxResults` parameters for paged queries.
+   * > This parameter is about to be deprecated. Use NextToken and MaxResults for paging instead.
    * 
    * @example
    * 10
@@ -190,7 +184,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The ID of the region. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to view the latest list of Alibaba Cloud regions.
+   * The region ID of the disk. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -200,9 +194,9 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group to which the snapshot belongs. When you filter by this parameter, the query can return a maximum of 1,000 snapshots.
+   * The ID of the resource group. When you use this parameter to filter resources, the resource count cannot exceed 1000.
    * 
-   * > You cannot filter resources that are in the default resource group.
+   * > Filtering by default resource group is not supported.
    * 
    * @example
    * rg-bp67acfmxazb4p****
@@ -212,7 +206,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * A JSON array that contains the IDs of up to 100 snapshots to query.
+   * The IDs of snapshots. The value is a JSON array that consists of up to 100 snapshot IDs. Separate the IDs with commas (,).
    * 
    * @example
    * ["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", … "s-bp67acfmxazb6p****"]
@@ -228,7 +222,7 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   snapshotLinkId?: string;
   /**
    * @remarks
-   * The snapshot name.
+   * The name of the snapshot.
    * 
    * @example
    * testSnapshotName
@@ -236,13 +230,11 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   snapshotName?: string;
   /**
    * @remarks
-   * The snapshot creation type. Valid values:
-   * 
-   * - `auto`: An automatically created snapshot.
-   * 
-   * - `user`: A manually created snapshot.
-   * 
-   * - `all` (Default): All snapshot creation types.
+   * The type of automatic creation. Valid values: 
+   *          
+   * - auto: automatic snapshot.
+   * - user: manual snapshot.
+   * - all (default): All automatic creation types.
    * 
    * @example
    * all
@@ -250,11 +242,10 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   snapshotType?: string;
   /**
    * @remarks
-   * The type of the source disk of the snapshot. Valid values:
-   * 
-   * - `system`: The snapshot was created from a system disk.
-   * 
-   * - `data`: The snapshot was created from a data disk.
+   * The type of the source disk. Valid values: 
+   *      
+   * - system: system disk.
+   * - data: data disk.
    * 
    * > The value is case-insensitive.
    * 
@@ -264,15 +255,12 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   sourceDiskType?: string;
   /**
    * @remarks
-   * The status of the snapshot. Valid values:
-   * 
-   * - `progressing`: The snapshot is being created.
-   * 
-   * - `accomplished`: The snapshot is complete.
-   * 
-   * - `failed`: Snapshot creation failed.
-   * 
-   * - `all` (Default): All snapshot statuses.
+   * The status of the snapshot. Valid values: 
+   *          
+   * - progressing: The snapshot is being created.
+   * - accomplished: The snapshot is created.
+   * - failed: The snapshot failed to be created.
+   * - all (default): All snapshot statuses.
    * 
    * @example
    * all
@@ -280,20 +268,17 @@ export class DescribeSnapshotsRequest extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The tags by which to filter snapshots.
+   * The tags.
    */
   tag?: DescribeSnapshotsRequestTag[];
   /**
    * @remarks
-   * The usage of the snapshot. Valid values:
-   * 
-   * - `image`: The snapshot is used to create a custom image.
-   * 
-   * - `disk`: The snapshot is used to create a cloud disk.
-   * 
-   * - `image_disk`: The snapshot is used to create a custom image and a data disk.
+   * Specifies whether the snapshot has been used to create images or disks. Valid values: 
    * 
-   * - `none`: The snapshot is not used.
+   * - image: The snapshot has been used to create custom images.
+   * - disk: The snapshot has been used to create disks.
+   * - image_disk: The snapshot has been used to create both data disks and custom images.
+   * - none: The snapshot has not been used.
    * 
    * @example
    * none