@alicloud/ecs20140526 7.8.5 → 7.9.0

package/src/models/DescribeAvailableResourceRequest.ts

@@ -5,9 +5,9 @@ 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).
+   * The number of vCPU cores of the instance type. For valid values, see [Instance family](https://help.aliyun.com/document_detail/25378.html).
    * 
-   * This parameter applies only when `DestinationResource` is set to `InstanceType`.
+   * This parameter takes effect only when DestinationResource is set to InstanceType.
    * 
    * @example
    * 2
@@ -15,23 +15,16 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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.
-   * 
+   * The category of the data disk. Valid values: 
+   *          
+   * - cloud: basic disk.
+   * - cloud_efficiency: ultra disk.
+   * - cloud_ssd: standard SSD.
+   * - ephemeral_ssd: local SSD.
+   * - cloud_essd: enterprise SSD (ESSD).
+   * - cloud_auto: ESSD AutoPL disk.
    * <props="china">
-   * 
-   * - cloud_essd_entry: ESSD Entry cloud disk.
+   * - cloud_essd_entry: ESSD Entry disk.
    * 
    * @example
    * cloud_ssd
@@ -47,25 +40,19 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   dedicatedHostId?: string;
   /**
    * @remarks
-   * The type of resource to query. Valid values:
-   * 
-   * - Zone: availability zone.
-   * 
+   * The type of resource to query. Valid values: 
+   *          
+   * - Zone: 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.
+   * > When DestinationResource is set to `SystemDisk`, you must specify InstanceType because system disks are restricted by instance types.
    * 
-   * For details on how to specify this parameter, see the **API description** section.
+   * For more information about how to set the DestinationResource parameter, see the **operation description** section of this topic.
    * 
    * This parameter is required.
    * 
@@ -75,11 +62,10 @@ 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.
+   * The billing method of the resource. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html). Valid values: 
+   *        
+   * - PrePaid: subscription.  
+   * - PostPaid: pay-as-you-go.
    * 
    * Default value: PostPaid.
    * 
@@ -89,9 +75,9 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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.
+   * The instance type. For more information, see [Instance family](https://help.aliyun.com/document_detail/25378.html). You can also invoke [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to query the most recent instance type list.
    * 
-   * For details on how to specify this parameter, see the **API description** section.
+   * For more information about how to set the InstanceType parameter, see the **operation description** section at the beginning of this topic.
    * 
    * @example
    * ecs.g5.large
@@ -99,11 +85,10 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   instanceType?: string;
   /**
    * @remarks
-   * Specifies whether the instance is I/O optimized. Valid values:
-   * 
-   * - none: The instance is not I/O optimized.
+   * Specifies whether the instance is an I/O optimized instance. Valid values:
    * 
-   * - optimized: The instance is I/O optimized.
+   * - none: non-I/O optimized instance.
+   * - optimized: I/O optimized instance.
    * 
    * Default value: optimized.
    * 
@@ -113,9 +98,9 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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).
+   * The memory size of the instance type. Unit: GiB. For valid values, see [Instance family](https://help.aliyun.com/document_detail/25378.html).
    * 
-   * This parameter applies only when `DestinationResource` is set to `InstanceType`.
+   * This parameter takes effect only when DestinationResource is set to InstanceType.
    * 
    * @example
    * 8.0
@@ -123,11 +108,10 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   memory?: number;
   /**
    * @remarks
-   * The network type. Valid values:
-   * 
-   * - vpc: VPC.
-   * 
-   * - classic: classic network.
+   * The network type. Valid values: 
+   *         
+   * - vpc: virtual private cloud (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
@@ -137,7 +121,7 @@ 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.
+   * The ID of the destination region. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -149,14 +133,11 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The resource type. Valid values:
+   * The type of the resource. Valid values:
    * 
    * - instance: ECS instance.
-   * 
    * - disk: cloud disk.
-   * 
    * - reservedinstance: reserved instance.
-   * 
    * - ddh: dedicated host.
    * 
    * @example
@@ -166,10 +147,9 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   /**
    * @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.
+   *          
+   * - Region: regional.
+   * - Zone: zonal.
    * 
    * @example
    * Region
@@ -177,15 +157,13 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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.
+   * The protection period of the spot instance. Unit: hours. Default value: 1. Valid values:
+   * - 1: After a spot instance is created, Alibaba Cloud ensures that the instance is not automatically released within 1 hour. After 1 hour, the system compares the bid price with the market price and checks the inventory to determine whether to retain automatic release the instance.
+   * - 0: After a spot instance is created, Alibaba Cloud does not ensure that the instance runs for 1 hour. The system compares the bid price with the market price and checks the inventory to determine whether to retain automatic release 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 an ECS system event notification 5 minutes before the instance is released. Spot instances are billed by second. Select an appropriate protection period based on the expected task execution duration.
    * 
-   * 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`.
+   * > This parameter takes effect only when `InstanceChargeType` is set to `PostPaid` and `SpotStrategy` is set to `SpotWithPriceLimit` or `SpotAsPriceGo`.
    * 
    * @example
    * 1
@@ -193,17 +171,15 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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.
+   * The bidding policy for pay-as-you-go instances. Valid values: 
+   *          
+   * - NoSpot: a regular pay-as-you-go instance.
+   * - SpotWithPriceLimit: a spot instance with a maximum price limit.
+   * - SpotAsPriceGo: a spot instance priced at the market price with the pay-as-you-go price as the upper limit.
    * 
    * Default value: NoSpot.
    * 
-   * This parameter applies only when `InstanceChargeType` is set to `PostPaid`.
+   * This parameter takes effect only when InstanceChargeType is set to `PostPaid`.
    * 
    * @example
    * NoSpot
@@ -211,34 +187,24 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   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.
-   * 
+   * The category of the system disk. Valid values: 
+   *          
+   * - cloud: basic disk.
+   * - cloud_efficiency: ultra disk.
+   * - cloud_ssd: standard SSD.
+   * - ephemeral_ssd: local SSD.
+   * - cloud_essd: enterprise SSD (ESSD).
+   * - cloud_auto: ESSD AutoPL disk.
    * <props="china">
+   * - cloud_essd_entry: ESSD Entry disk.
    * 
-   * - cloud_essd_entry: ESSD Entry cloud disk.
-   * 
-   * 
-   * 
-   * 
-   * About the default value:
    * 
-   * - If `InstanceType` specifies a discontinued instance type, the default value is `cloud`.
+   * Default value description:
    * 
-   * - 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).
+   * - If InstanceType is set to a retired instance type, the default value is `cloud`.
+   * - In other cases, the default value is `cloud_efficiency`.<props="china">After January 30, 2026, for instance types that support only cloud_essd, the default value is changed from cloud_efficiency to cloud_essd PL0. For more information, see [Change notice](https://www.aliyun.com/notice/117844).
    * 
-   * > When `ResourceType` is set to `instance` and `DestinationResource` is set to `DataDisk`, this parameter is required.
+   * > When ResourceType is set to instance and DestinationResource is set to DataDisk, the SystemDiskCategory parameter is required. If you do not specify this parameter, the default value takes effect.
    * 
    * @example
    * cloud_ssd
@@ -246,9 +212,9 @@ export class DescribeAvailableResourceRequest extends $dara.Model {
   systemDiskCategory?: string;
   /**
    * @remarks
-   * The ID of the availability zone.
+   * The zone ID.
    * 
-   * 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.
+   * Default value: null. The operation returns resources that match the query conditions across all zones in the specified region (RegionId).
    * 
    * @example
    * cn-hangzhou-e

package/src/models/DescribeAvailableResourceResponseBody.ts

@@ -186,10 +186,6 @@ export class DescribeAvailableResourceResponseBodyAvailableZones extends $dara.M
 }
 
 export class DescribeAvailableResourceResponseBody extends $dara.Model {
-  /**
-   * @remarks
-   * Information about the availability zones.
-   */
   availableZones?: DescribeAvailableResourceResponseBodyAvailableZones;
   /**
    * @remarks

package/src/models/DescribeBandwidthLimitationRequest.ts

@@ -7,9 +7,8 @@ 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.
    * 
@@ -19,7 +18,7 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
   instanceChargeType?: string;
   /**
    * @remarks
-   * The instance type. For information about the values, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
+   * The instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
    * 
    * This parameter is required.
    * 
@@ -29,12 +28,10 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
   instanceType?: string;
   /**
    * @remarks
-   * Specifies the operation for which to query the maximum public bandwidth. Valid values:
+   * The operation type for querying public bandwidth limits. Valid values:
    * 
    * - Upgrade: upgrades the public bandwidth.
-   * 
    * - Downgrade: downgrades the public bandwidth.
-   * 
    * - Create: creates an ECS instance.
    * 
    * Default value: Create.
@@ -47,7 +44,7 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
   ownerId?: 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 ID of the target region. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -59,7 +56,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.
+   * > When you set the OperationType parameter to Upgrade or Downgrade, the ResourceId parameter is required.
    * 
    * @example
    * i-bp67acfmxazb4ph***
@@ -69,13 +66,11 @@ export class DescribeBandwidthLimitationRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @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.
+   * The bidding strategy for pay-as-you-go instances. Valid values:
    * 
-   * - 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: a regular pay-as-you-go instance.
+   * - SpotWithPriceLimit: a preemptible instance with a user-defined maximum hourly price.
+   * - SpotAsPriceGo: a preemptible instance priced at the market price at the time of purchase.
    * 
    * Default value: NoSpot.
    * 

package/src/models/DescribeDiskMonitorDataRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeDiskMonitorDataRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the cloud disk that you want to query.
+   * The ID of the disk to query.
    * 
    * This parameter is required.
    * 
@@ -15,7 +15,7 @@ export class DescribeDiskMonitorDataRequest extends $dara.Model {
   diskId?: string;
   /**
    * @remarks
-   * The end of the time range to query. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the time is rounded up to the next minute.
+   * The end time of the data. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the end time is automatically set to the beginning of the next minute.
    * 
    * This parameter is required.
    * 
@@ -27,17 +27,15 @@ export class DescribeDiskMonitorDataRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The interval at which to retrieve the monitoring data. Unit: seconds. Valid values:
+   * The granularity of the data. Unit: seconds. Valid values:
    * 
-   * - 60
-   * 
-   * - 600
-   * 
-   * - 3600
+   * - 60.
+   * - 600.
+   * - 3600.
    * 
    * Default value: 60.
    * 
-   * > Up to 400 monitoring data entries can be returned at a time. Make sure that the TotalCount value does not exceed 400. The value is calculated by using the following formula: TotalCount = (EndTime - StartTime)/Period.
+   * > The value of (EndTime – StartTime) / Period must be less than or equal to 400. A maximum of 400 data entries can be returned at a time.
    * 
    * @example
    * 60
@@ -47,9 +45,9 @@ export class DescribeDiskMonitorDataRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The beginning of the time range to query. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the time is rounded up to the next minute.
+   * The start time of the data. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the start time is automatically set to the beginning of the next minute.
    * 
-   * > You can query the monitoring data in the last 30 days. If the value of `StartTime` is more than 30 days earlier than the current time, an error is returned.
+   * > You can query the monitoring information of up to the last 30 days. The `StartTime` parameter cannot be more than 30 days earlier than the current time.
    * 
    * This parameter is required.
    * 

package/src/models/DescribeDiskMonitorDataResponseBody.ts

@@ -90,7 +90,7 @@ export class DescribeDiskMonitorDataResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of monitoring data entries returned.
+   * The number of entries returned for disk usage information, which is the number of periods.
    * 
    * @example
    * 3