@alicloud/ecs20140526 7.8.3 → 7.8.5

package/src/models/DescribeAutoProvisioningGroupsRequest.ts

@@ -5,9 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeAutoProvisioningGroupsRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N that is added to the auto provisioning group.
-   * 
-   * Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot contain http:// or https://. The tag key cannot start with acs: or aliyun.
+   * The key of the tag. The key can be up to 128 characters in length and cannot be an empty string. It cannot start with `aliyun` or `acs:` or contain http\\:// or https\\://.
    * 
    * @example
    * TestKey
@@ -15,9 +13,7 @@ export class DescribeAutoProvisioningGroupsRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N that is added to the auto provisioning group.
-   * 
-   * Valid values of N: 1 to 20. The tag value can be an empty string. The tag key can be up to 128 characters in length and cannot contain http:// or https://.
+   * The value of the tag. The value can be up to 128 characters in length and can be an empty string. It cannot contain `http://` or `https://`.
    * 
    * @example
    * TestValue
@@ -49,7 +45,7 @@ export class DescribeAutoProvisioningGroupsRequestTag extends $dara.Model {
 export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the auto provisioning group. You can specify up to 20 IDs.
+   * The IDs of the auto provisioning groups. You can specify up to 20 IDs.
    * 
    * @example
    * apg-sn54avj8htgvtyh8****
@@ -65,7 +61,7 @@ export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   autoProvisioningGroupName?: string;
   /**
    * @remarks
-   * The status of the auto provisioning group.
+   * The statuses of the auto provisioning groups.
    * 
    * @example
    * active
@@ -76,9 +72,9 @@ export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The page number.
+   * The page number to return.
    * 
-   * Pages start from page 1.
+   * Start value: 1.
    * 
    * Default value: 1.
    * 
@@ -88,9 +84,9 @@ export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries per page.
+   * The number of entries to return per page.
    * 
-   * Valid values: 1 to 100.
+   * Maximum value: 100.
    * 
    * Default value: 10.
    * 
@@ -100,7 +96,7 @@ export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The region ID of the auto provisioning group.
+   * The ID of the region where the auto provisioning group is located.
    * 
    * This parameter is required.
    * 
@@ -120,7 +116,7 @@ export class DescribeAutoProvisioningGroupsRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The tags that are added to the auto provisioning group.
+   * The tags used to filter auto provisioning groups. You can specify up to 20 tags.
    */
   tag?: DescribeAutoProvisioningGroupsRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/DescribeAutoProvisioningGroupsResponseBody.ts

@@ -443,10 +443,14 @@ export class DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroups ex
 }
 
 export class DescribeAutoProvisioningGroupsResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The auto provisioning groups.
+   */
   autoProvisioningGroups?: DescribeAutoProvisioningGroupsResponseBodyAutoProvisioningGroups;
   /**
    * @remarks
-   * The number of the page returned.
+   * The page number.
    * 
    * @example
    * 1
@@ -454,7 +458,7 @@ export class DescribeAutoProvisioningGroupsResponseBody extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries returned per page.
+   * The number of entries per page.
    * 
    * @example
    * 10
@@ -462,7 +466,7 @@ export class DescribeAutoProvisioningGroupsResponseBody extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * 745CEC9F-0DD7-4451-9FE7-8B752F39****
@@ -470,7 +474,7 @@ export class DescribeAutoProvisioningGroupsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The number of queried auto provisioning groups.
+   * The total number of auto provisioning groups found.
    * 
    * @example
    * 10

package/src/models/DescribeAutoSnapshotPolicyAssociationsRequest.ts

@@ -7,7 +7,7 @@ export class DescribeAutoSnapshotPolicyAssociationsRequest extends $dara.Model {
    * @remarks
    * The ID of the automatic snapshot policy.
    * 
-   * *   You can specify only one of AutoSnapshotPolicyId and DiskId.
+   * - You can specify only one of AutoSnapshotPolicyId and DiskId.
    * 
    * @example
    * sp-bp12quk7gqhhuu1f****
@@ -17,7 +17,7 @@ export class DescribeAutoSnapshotPolicyAssociationsRequest extends $dara.Model {
    * @remarks
    * The ID of the disk.
    * 
-   * *   You can specify only one of AutoSnapshotPolicyId and DiskId.
+   * - You can specify only one of AutoSnapshotPolicyId and DiskId.
    * 
    * @example
    * d-bp67acfmxazb4p****
@@ -29,8 +29,9 @@ export class DescribeAutoSnapshotPolicyAssociationsRequest extends $dara.Model {
    * 
    * Default value:
    * 
-   * *   If you do not specify this parameter or if you set this parameter to a value that is smaller than 10, the default value is 10.
-   * *   If you set a value greater than 100, the default value is 100.
+   * - If you do not specify this parameter or if you set this parameter to a value that is smaller than 10, the default value is 10.
+   * 
+   * - If you set a value greater than 100, the default value is 100.
    * 
    * @example
    * 10

package/src/models/DescribeAutoSnapshotPolicyExRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeAutoSnapshotPolicyExRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N of the automatic snapshot policy. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot contain http:// or https://. The tag key cannot start with acs: or aliyun.
+   * The key of tag N of the automatic snapshot policy. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot contain http\\:// or https\\://. The tag key cannot start with acs: or aliyun.
    * 
    * @example
    * TestKey
@@ -13,7 +13,7 @@ export class DescribeAutoSnapshotPolicyExRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N of the automatic snapshot policy. 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://. The tag value cannot start with acs:.
+   * The value of tag N of the automatic snapshot policy. 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\\://. The tag value cannot start with acs:.
    * 
    * @example
    * TestValue

package/src/models/DescribeAvailableResourceRequest.ts

@@ -4,22 +4,69 @@ import * as $dara from '@darabonba/typescript';
 
 export class DescribeAvailableResourceRequest extends $dara.Model {
   /**
+   * @remarks
+   * The number of vCPU cores for the instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
+   * 
+   * This parameter applies only when `DestinationResource` is set to `InstanceType`.
+   * 
    * @example
    * 2
    */
   cores?: number;
   /**
+   * @remarks
+   * The category of the data disk. Valid values:
+   * 
+   * - cloud: basic cloud disk.
+   * 
+   * - cloud_efficiency: ultra cloud disk.
+   * 
+   * - cloud_ssd: SSD cloud disk.
+   * 
+   * - ephemeral_ssd: local SSD disk.
+   * 
+   * - cloud_essd: ESSD cloud disk.
+   * 
+   * - cloud_auto: ESSD AutoPL cloud disk.
+   * 
+   * <props="china">
+   * 
+   * - cloud_essd_entry: ESSD Entry cloud disk.
+   * 
    * @example
    * cloud_ssd
    */
   dataDiskCategory?: string;
   /**
+   * @remarks
+   * The ID of the dedicated host.
+   * 
    * @example
    * dh-bp165p6xk2tlw61e****
    */
   dedicatedHostId?: string;
   /**
    * @remarks
+   * The type of resource to query. Valid values:
+   * 
+   * - Zone: availability zone.
+   * 
+   * - IoOptimized: I/O optimized.
+   * 
+   * - InstanceType: instance type.
+   * 
+   * - Network: network type.
+   * 
+   * - ddh: dedicated host.
+   * 
+   * - SystemDisk: system disk.
+   * 
+   * - DataDisk: data disk.
+   * 
+   * > When `DestinationResource` is set to `SystemDisk`, you must specify `InstanceType` because available system disks depend on the instance type.
+   * 
+   * For details on how to specify this parameter, see the **API description** section.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -27,26 +74,61 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
    */
   destinationResource?: string;
   /**
+   * @remarks
+   * The billing method of the resource. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html). Valid values:
+   * 
+   * - PrePaid: The subscription billing method.
+   * 
+   * - PostPaid: The pay-as-you-go billing method.
+   * 
+   * Default value: PostPaid.
+   * 
    * @example
    * PrePaid
    */
   instanceChargeType?: string;
   /**
+   * @remarks
+   * The instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html). You can also call the [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) operation to get the latest list of instance types.
+   * 
+   * For details on how to specify this parameter, see the **API description** section.
+   * 
    * @example
    * ecs.g5.large
    */
   instanceType?: string;
   /**
+   * @remarks
+   * Specifies whether the instance is I/O optimized. Valid values:
+   * 
+   * - none: The instance is not I/O optimized.
+   * 
+   * - optimized: The instance is I/O optimized.
+   * 
+   * Default value: optimized.
+   * 
    * @example
    * optimized
    */
   ioOptimized?: string;
   /**
+   * @remarks
+   * The memory size for the instance type, in GiB. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
+   * 
+   * This parameter applies only when `DestinationResource` is set to `InstanceType`.
+   * 
    * @example
    * 8.0
    */
   memory?: number;
   /**
+   * @remarks
+   * The network type. Valid values:
+   * 
+   * - vpc: VPC.
+   * 
+   * - classic: classic network.
+   * 
    * @example
    * vpc
    */
@@ -55,6 +137,8 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
+   * The ID of the region. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to get the latest list of Alibaba Cloud regions.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -64,31 +148,108 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   resourceOwnerAccount?: string;
   resourceOwnerId?: number;
   /**
+   * @remarks
+   * The resource type. Valid values:
+   * 
+   * - instance: ECS instance.
+   * 
+   * - disk: cloud disk.
+   * 
+   * - reservedinstance: reserved instance.
+   * 
+   * - ddh: dedicated host.
+   * 
    * @example
    * instance
    */
   resourceType?: string;
   /**
+   * @remarks
+   * The scope of the reserved instance. Valid values:
+   * 
+   * - Region: The reserved instance is scoped to a region.
+   * 
+   * - Zone: The reserved instance is scoped to an availability zone.
+   * 
    * @example
    * Region
    */
   scope?: string;
   /**
+   * @remarks
+   * The protection period for the spot instance. Unit: hours. Default value: 1. Valid values:
+   * 
+   * - 1: Alibaba Cloud guarantees that the instance will not be automatically reclaimed within 1 hour of creation. After the 1-hour protection period ends, the system compares the bid price with the market price and checks the resource inventory to determine whether to retain or reclaim the instance.
+   * 
+   * - 0: Alibaba Cloud does not guarantee that the instance runs for 1 hour. The system compares the bid price with the market price and checks the resource inventory to determine whether to retain or reclaim the instance.
+   * 
+   * Alibaba Cloud sends a notification through ECS system events 5 minutes before reclaiming an instance. Spot instances are billed by the second. We recommend that you select a protection period based on the expected runtime of your tasks.
+   * 
+   * > This parameter applies only when `InstanceChargeType` is set to `PostPaid` and `SpotStrategy` is set to `SpotWithPriceLimit` or `SpotAsPriceGo`.
+   * 
    * @example
    * 1
    */
   spotDuration?: number;
   /**
+   * @remarks
+   * The bidding strategy for pay-as-you-go instances. Valid values:
+   * 
+   * - NoSpot: A standard pay-as-you-go instance.
+   * 
+   * - SpotWithPriceLimit: A spot instance for which you specify a maximum hourly price.
+   * 
+   * - SpotAsPriceGo: A spot instance for which the system automatically bids based on the current market price, up to the pay-as-you-go price.
+   * 
+   * Default value: NoSpot.
+   * 
+   * This parameter applies only when `InstanceChargeType` is set to `PostPaid`.
+   * 
    * @example
    * NoSpot
    */
   spotStrategy?: string;
   /**
+   * @remarks
+   * The category of the system disk. Valid values:
+   * 
+   * - cloud: basic cloud disk.
+   * 
+   * - cloud_efficiency: ultra cloud disk.
+   * 
+   * - cloud_ssd: SSD cloud disk.
+   * 
+   * - ephemeral_ssd: local SSD disk.
+   * 
+   * - cloud_essd: ESSD cloud disk.
+   * 
+   * - cloud_auto: ESSD AutoPL cloud disk.
+   * 
+   * <props="china">
+   * 
+   * - cloud_essd_entry: ESSD Entry cloud disk.
+   * 
+   * 
+   * 
+   * 
+   * About the default value:
+   * 
+   * - If `InstanceType` specifies a discontinued instance type, the default value is `cloud`.
+   * 
+   * - Otherwise, the default value is `cloud_efficiency`. <props="china">After January 30, 2026, for instance types that support only ESSD cloud disks, the default value changes from cloud_efficiency to cloud_essd PL0. For more information, see the [official announcement](https://www.aliyun.com/notice/117844).
+   * 
+   * > When `ResourceType` is set to `instance` and `DestinationResource` is set to `DataDisk`, this parameter is required.
+   * 
    * @example
    * cloud_ssd
    */
   systemDiskCategory?: string;
   /**
+   * @remarks
+   * The ID of the availability zone.
+   * 
+   * This parameter has no default value. If you do not specify this parameter, the operation returns resources that meet the query conditions in all availability zones within the specified region.
+   * 
    * @example
    * cn-hangzhou-e
    */

package/src/models/DescribeAvailableResourceResponseBody.ts

@@ -186,8 +186,15 @@ export class DescribeAvailableResourceResponseBodyAvailableZones extends $dara.M
 }
 
 export class DescribeAvailableResourceResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * Information about the availability zones.
+   */
   availableZones?: DescribeAvailableResourceResponseBodyAvailableZones;
   /**
+   * @remarks
+   * The request ID.
+   * 
    * @example
    * 0041D94C-FB92-4C49-B115-259DA1C*****
    */

package/src/models/DescribeBandwidthLimitationRequest.ts

@@ -7,8 +7,9 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
    * @remarks
    * The billing method of the instance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html). Valid values:
    * 
-   * *   PrePaid: subscription
-   * *   PostPaid: pay-as-you-go
+   * - PrePaid: subscription
+   * 
+   * - PostPaid: pay-as-you-go
    * 
    * Default value: PostPaid.
    * 
@@ -30,9 +31,11 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
    * @remarks
    * Specifies the operation for which to query the maximum public bandwidth. Valid values:
    * 
-   * *   Upgrade: upgrades the public bandwidth.
-   * *   Downgrade: downgrades the public bandwidth.
-   * *   Create: creates an ECS instance.
+   * - Upgrade: upgrades the public bandwidth.
+   * 
+   * - Downgrade: downgrades the public bandwidth.
+   * 
+   * - Create: creates an ECS instance.
    * 
    * Default value: Create.
    * 
@@ -56,7 +59,7 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
    * @remarks
    * The resource ID.
    * 
-   * >  This parameter is required when the OperationType parameter is set to Upgrade or Downgrade.
+   * > This parameter is required when the OperationType parameter is set to Upgrade or Downgrade.
    * 
    * @example
    * i-bp67acfmxazb4ph***
@@ -68,13 +71,15 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
    * @remarks
    * The bidding policy for the pay-as-you-go instance. Valid values:
    * 
-   * *   NoSpot: The instance is a pay-as-you-go instance.
-   * *   SpotWithPriceLimit: The instance is a spot instance for which you can specify the maximum hourly price.
-   * *   SpotAsPriceGo: The instance is a spot instance for which the market price at the time of purchase is automatically used as the bid price. The market price can be up to the pay-as-you-go price.
+   * - NoSpot: The instance is a pay-as-you-go instance.
+   * 
+   * - SpotWithPriceLimit: The instance is a spot instance for which you can specify the maximum hourly price.
+   * 
+   * - SpotAsPriceGo: The instance is a spot instance for which the market price at the time of purchase is automatically used as the bid price. The market price can be up to the pay-as-you-go price.
    * 
    * Default value: NoSpot.
    * 
-   * >  The SpotStrategy parameter takes effect only when the InstanceChargeType parameter is set to PostPaid.
+   * > The SpotStrategy parameter takes effect only when the InstanceChargeType parameter is set to PostPaid.
    * 
    * @example
    * NoSpot

package/src/models/DescribeBandwidthPackagesRequest.ts

@@ -3,14 +3,32 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class DescribeBandwidthPackagesRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The ID of the bandwidth package.
+   */
   bandwidthPackageId?: string;
+  /**
+   * @remarks
+   * The ID of the nat gateway. If specified, the operation returns only bandwidth packages associated with the specified nat gateway.
+   */
   natGatewayId?: string;
   ownerAccount?: string;
   ownerId?: number;
+  /**
+   * @remarks
+   * The page number. Starting value: 1. Default value: 1.
+   */
   pageNumber?: number;
+  /**
+   * @remarks
+   * The number of entries to return on each page. Valid values: 1 to 100. Default value: 20.
+   */
   pageSize?: number;
   /**
    * @remarks
+   * The ID of the region where the bandwidth package is located.
+   * 
    * This parameter is required.
    */
   regionId?: string;

package/src/models/DescribeBandwidthPackagesResponseBody.ts

@@ -149,10 +149,30 @@ export class DescribeBandwidthPackagesResponseBodyBandwidthPackages extends $dar
 }
 
 export class DescribeBandwidthPackagesResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * Details of the queried bandwidth packages.
+   */
   bandwidthPackages?: DescribeBandwidthPackagesResponseBodyBandwidthPackages;
+  /**
+   * @remarks
+   * The page number.
+   */
   pageNumber?: number;
+  /**
+   * @remarks
+   * The number of entries per page.
+   */
   pageSize?: number;
+  /**
+   * @remarks
+   * The request ID.
+   */
   requestId?: string;
+  /**
+   * @remarks
+   * The total number of matching entries.
+   */
   totalCount?: number;
   static names(): { [key: string]: string } {
     return {

package/src/models/DescribeCapacityReservationInstancesRequest.ts

@@ -40,8 +40,9 @@ export class DescribeCapacityReservationInstancesRequest extends $dara.Model {
    * @remarks
    * The number of entries per page.
    * 
-   * *   Valid values: 1 to 100.
-   * *   Default value: 10.
+   * - Valid values: 1 to 100.
+   * 
+   * - Default value: 10.
    * 
    * @example
    * 10