@alicloud/ecs20140526 7.9.0 → 7.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/dist/client.d.ts +108 -110
  2. package/dist/client.js +108 -110
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CloneDisksRequest.d.ts +55 -80
  5. package/dist/models/CloneDisksRequest.js.map +1 -1
  6. package/dist/models/CloneDisksResponseBody.d.ts +2 -2
  7. package/dist/models/CreateAutoProvisioningGroupRequest.d.ts +286 -380
  8. package/dist/models/CreateAutoProvisioningGroupRequest.js.map +1 -1
  9. package/dist/models/CreateAutoProvisioningGroupShrinkRequest.d.ts +282 -375
  10. package/dist/models/CreateAutoProvisioningGroupShrinkRequest.js.map +1 -1
  11. package/dist/models/CreateImageRequest.d.ts +43 -88
  12. package/dist/models/CreateImageRequest.js.map +1 -1
  13. package/dist/models/CreateImageResponseBody.d.ts +2 -2
  14. package/dist/models/CreateLaunchTemplateRequest.d.ts +235 -278
  15. package/dist/models/CreateLaunchTemplateRequest.js.map +1 -1
  16. package/dist/models/CreateLaunchTemplateResponseBody.d.ts +3 -3
  17. package/dist/models/CreateVswitchRequest.d.ts +0 -29
  18. package/dist/models/CreateVswitchRequest.js.map +1 -1
  19. package/dist/models/CreateVswitchResponseBody.d.ts +0 -8
  20. package/dist/models/CreateVswitchResponseBody.js.map +1 -1
  21. package/dist/models/DescribeImagesRequest.d.ts +61 -89
  22. package/dist/models/DescribeImagesRequest.js.map +1 -1
  23. package/dist/models/DescribeImagesResponseBody.d.ts +5 -5
  24. package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +4 -4
  25. package/dist/models/RenewElasticityAssurancesRequest.d.ts +3 -3
  26. package/package.json +1 -1
  27. package/src/client.ts +108 -110
  28. package/src/models/CloneDisksRequest.ts +55 -80
  29. package/src/models/CloneDisksResponseBody.ts +2 -2
  30. package/src/models/CreateAutoProvisioningGroupRequest.ts +287 -381
  31. package/src/models/CreateAutoProvisioningGroupShrinkRequest.ts +283 -376
  32. package/src/models/CreateImageRequest.ts +43 -88
  33. package/src/models/CreateImageResponseBody.ts +2 -2
  34. package/src/models/CreateLaunchTemplateRequest.ts +235 -278
  35. package/src/models/CreateLaunchTemplateResponseBody.ts +3 -3
  36. package/src/models/CreateVswitchRequest.ts +0 -29
  37. package/src/models/CreateVswitchResponseBody.ts +0 -8
  38. package/src/models/DescribeImagesRequest.ts +62 -90
  39. package/src/models/DescribeImagesResponseBody.ts +5 -5
  40. package/src/models/DescribeRecommendInstanceTypeRequest.ts +4 -4
  41. package/src/models/RenewElasticityAssurancesRequest.ts +3 -3
package/dist/client.js CHANGED
@@ -2234,29 +2234,29 @@ class Client extends openapi_core_1.default {
2234
2234
  return await this.cancelTaskWithOptions(request, runtime);
2235
2235
  }
2236
2236
  /**
2237
- * Cloud disk cloning allows you to quickly create a new cloud disk in the same availability zone containing the same data as the source disk. You can customize the new disk\\"s capacity, type, and encryption attributes. After attaching the disk to an instance, you can use it to rapidly replicate business data or scale your services horizontally.
2237
+ * Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
2238
2238
  *
2239
2239
  * @remarks
2240
- * > The cloud disk cloning feature is free. However, the resulting destination disk is billed based on block storage rules. Charges vary by disk type and can include capacity, provisioned performance, and burst performance. Billing for all items begins at creation—except for burst performance fees, which are charged only after a burst occurs—and applies regardless of whether the disk is attached to an instance.
2241
- * ### Usage
2242
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2240
+ * > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2241
+ * ### How to use
2242
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2243
2243
  * ### Features
2244
- * - You can only clone ESSD cloud disks (cloud_essd, cloud_auto, cloud_essd_entry, and cloud_regional_disk_auto) to create a `destination disk`, which must also be an ESSD type.
2245
- * - A non-zone-redundant cloud disk can only be cloned to a non-zone-redundant disk. A zone-redundant cloud disk can only be cloned to another zone-redundant cloud disk.
2246
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2247
- * - You can specify the type and performance level for the `destination disk`.
2248
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2249
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2250
- * - You can enable encryption and change the encryption key for the `destination disk`. If the `source disk` is encrypted, the destination disk must also be encrypted. However, you can use a different encryption key.
2251
- * - You can use a subscription cloud disk as the `source disk`. The disk can still be used as a `source disk` even after its subscription expires.
2252
- * - A `destination disk` created by cloning cannot be re-initialized.
2253
- * - While you cannot clone entire storage sets or dedicated storage clusters, you can use a disk from within them as a `source disk`. The resulting destination disk is a standalone disk and will not belong to the original storage set or cluster.
2254
- * - `source disk` status requirements
2255
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2256
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2257
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2258
- * - A disk that is being scaled up cannot be used as a `source disk`.
2259
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2244
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
2245
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2246
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2247
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2248
+ * - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
2249
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2250
+ * - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2251
+ * - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
2252
+ * - The `new disk` created by cloning does not support reinitialization.
2253
+ * - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2254
+ * - `Source disk` status restrictions:
2255
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2256
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2257
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2258
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2259
+ * - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
2260
2260
  *
2261
2261
  * @param request - CloneDisksRequest
2262
2262
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2336,29 +2336,29 @@ class Client extends openapi_core_1.default {
2336
2336
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CloneDisksResponse({}));
2337
2337
  }
2338
2338
  /**
2339
- * Cloud disk cloning allows you to quickly create a new cloud disk in the same availability zone containing the same data as the source disk. You can customize the new disk\\"s capacity, type, and encryption attributes. After attaching the disk to an instance, you can use it to rapidly replicate business data or scale your services horizontally.
2339
+ * Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
2340
2340
  *
2341
2341
  * @remarks
2342
- * > The cloud disk cloning feature is free. However, the resulting destination disk is billed based on block storage rules. Charges vary by disk type and can include capacity, provisioned performance, and burst performance. Billing for all items begins at creation—except for burst performance fees, which are charged only after a burst occurs—and applies regardless of whether the disk is attached to an instance.
2343
- * ### Usage
2344
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2342
+ * > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2343
+ * ### How to use
2344
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2345
2345
  * ### Features
2346
- * - You can only clone ESSD cloud disks (cloud_essd, cloud_auto, cloud_essd_entry, and cloud_regional_disk_auto) to create a `destination disk`, which must also be an ESSD type.
2347
- * - A non-zone-redundant cloud disk can only be cloned to a non-zone-redundant disk. A zone-redundant cloud disk can only be cloned to another zone-redundant cloud disk.
2348
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2349
- * - You can specify the type and performance level for the `destination disk`.
2350
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2351
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2352
- * - You can enable encryption and change the encryption key for the `destination disk`. If the `source disk` is encrypted, the destination disk must also be encrypted. However, you can use a different encryption key.
2353
- * - You can use a subscription cloud disk as the `source disk`. The disk can still be used as a `source disk` even after its subscription expires.
2354
- * - A `destination disk` created by cloning cannot be re-initialized.
2355
- * - While you cannot clone entire storage sets or dedicated storage clusters, you can use a disk from within them as a `source disk`. The resulting destination disk is a standalone disk and will not belong to the original storage set or cluster.
2356
- * - `source disk` status requirements
2357
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2358
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2359
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2360
- * - A disk that is being scaled up cannot be used as a `source disk`.
2361
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2346
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
2347
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2348
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2349
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2350
+ * - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
2351
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2352
+ * - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2353
+ * - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
2354
+ * - The `new disk` created by cloning does not support reinitialization.
2355
+ * - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2356
+ * - `Source disk` status restrictions:
2357
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2358
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2359
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2360
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2361
+ * - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
2362
2362
  *
2363
2363
  * @param request - CloneDisksRequest
2364
2364
  * @returns CloneDisksResponse
@@ -2805,13 +2805,13 @@ class Client extends openapi_core_1.default {
2805
2805
  return await this.createActivationWithOptions(request, runtime);
2806
2806
  }
2807
2807
  /**
2808
- * Create an auto provisioning group.
2808
+ * Creates an auto provisioning group.
2809
2809
  *
2810
2810
  * @remarks
2811
- * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create multiple ECS instances](https://help.aliyun.com/document_detail/200772.html).
2812
- * - Auto provisioning schedules and maintains compute resources through provisioning groups. Use auto provisioning groups to provide stable computing power and mitigate instability caused by the spot instance reclamation mechanism.
2813
- * - Auto provisioning is a free feature. You pay only for the instance resources created through the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2814
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
2811
+ * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
2812
+ * - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
2813
+ * - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2814
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
2815
2815
  *
2816
2816
  * @param tmpReq - CreateAutoProvisioningGroupRequest
2817
2817
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2953,13 +2953,13 @@ class Client extends openapi_core_1.default {
2953
2953
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoProvisioningGroupResponse({}));
2954
2954
  }
2955
2955
  /**
2956
- * Create an auto provisioning group.
2956
+ * Creates an auto provisioning group.
2957
2957
  *
2958
2958
  * @remarks
2959
- * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create multiple ECS instances](https://help.aliyun.com/document_detail/200772.html).
2960
- * - Auto provisioning schedules and maintains compute resources through provisioning groups. Use auto provisioning groups to provide stable computing power and mitigate instability caused by the spot instance reclamation mechanism.
2961
- * - Auto provisioning is a free feature. You pay only for the instance resources created through the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2962
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
2959
+ * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
2960
+ * - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
2961
+ * - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2962
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
2963
2963
  *
2964
2964
  * @param request - CreateAutoProvisioningGroupRequest
2965
2965
  * @returns CreateAutoProvisioningGroupResponse
@@ -4009,26 +4009,25 @@ class Client extends openapi_core_1.default {
4009
4009
  return await this.createHpcClusterWithOptions(request, runtime);
4010
4010
  }
4011
4011
  /**
4012
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4012
+ * Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
4013
4013
  *
4014
4014
  * @remarks
4015
- * ### Usage notes
4016
- * - This operation is asynchronous. A successful request returns an image ID, but the image is not created immediately. You can call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image status. The image is ready for use when its status changes to `Available`. For more information, see [Overview of custom images](https://help.aliyun.com/document_detail/172789.html).
4017
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4018
- * - We recommend configuring the image check parameter `DetectionStrategy` when you create an image. This helps the system optimize your image. For more information, see [Overview of image check](https://help.aliyun.com/document_detail/439819.html).
4019
- * This operation provides three methods to create a custom image. The request parameters are prioritized as follows: InstanceId > DiskDeviceMapping > SnapshotId. If your request includes two or more of these parameters, the operation creates the image based on the parameter with the highest priority.
4015
+ * ### Before you begin
4016
+ * - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
4017
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4018
+ * - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
4019
+ * The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
4020
4020
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4021
- * - The instance must be in the `Running` or `Stopped` state.
4022
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4023
- * >Notice:
4024
- * Data cached in memory on a running instance may not be written to disk. This can cause data inconsistencies between the custom image and the instance. We recommend stopping the instance by calling [StopInstances](https://help.aliyun.com/document_detail/155372.html) before creating an image.
4025
- *
4026
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4027
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4028
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4029
- * - You can specify only one system disk snapshot.
4030
- * - You can specify up to 16 data disk snapshots. If you do not specify `DiskDeviceMapping.N.SnapshotId`, the system creates an empty data disk with the default capacity.
4031
- * > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
4021
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4022
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4023
+ * >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
4024
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4025
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4026
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4027
+ * - Only one system disk snapshot can be specified.
4028
+ * - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
4029
+ *
4030
+ * > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
4032
4031
  *
4033
4032
  * @param request - CreateImageRequest
4034
4033
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4117,26 +4116,25 @@ class Client extends openapi_core_1.default {
4117
4116
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateImageResponse({}));
4118
4117
  }
4119
4118
  /**
4120
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4119
+ * Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
4121
4120
  *
4122
4121
  * @remarks
4123
- * ### Usage notes
4124
- * - This operation is asynchronous. A successful request returns an image ID, but the image is not created immediately. You can call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image status. The image is ready for use when its status changes to `Available`. For more information, see [Overview of custom images](https://help.aliyun.com/document_detail/172789.html).
4125
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4126
- * - We recommend configuring the image check parameter `DetectionStrategy` when you create an image. This helps the system optimize your image. For more information, see [Overview of image check](https://help.aliyun.com/document_detail/439819.html).
4127
- * This operation provides three methods to create a custom image. The request parameters are prioritized as follows: InstanceId > DiskDeviceMapping > SnapshotId. If your request includes two or more of these parameters, the operation creates the image based on the parameter with the highest priority.
4122
+ * ### Before you begin
4123
+ * - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
4124
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4125
+ * - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
4126
+ * The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
4128
4127
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4129
- * - The instance must be in the `Running` or `Stopped` state.
4130
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4131
- * >Notice:
4132
- * Data cached in memory on a running instance may not be written to disk. This can cause data inconsistencies between the custom image and the instance. We recommend stopping the instance by calling [StopInstances](https://help.aliyun.com/document_detail/155372.html) before creating an image.
4133
- *
4134
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4135
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4136
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4137
- * - You can specify only one system disk snapshot.
4138
- * - You can specify up to 16 data disk snapshots. If you do not specify `DiskDeviceMapping.N.SnapshotId`, the system creates an empty data disk with the default capacity.
4139
- * > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
4128
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4129
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4130
+ * >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
4131
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4132
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4133
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4134
+ * - Only one system disk snapshot can be specified.
4135
+ * - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
4136
+ *
4137
+ * > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
4140
4138
  *
4141
4139
  * @param request - CreateImageRequest
4142
4140
  * @returns CreateImageResponse
@@ -4728,15 +4726,15 @@ class Client extends openapi_core_1.default {
4728
4726
  return await this.createKeyPairWithOptions(request, runtime);
4729
4727
  }
4730
4728
  /**
4731
- * Create an ECS instance launch template, abbreviated as a template. An instance launch template eliminates the need to enter numerous configuration parameters each time you create an instance.
4729
+ * Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
4732
4730
  *
4733
4731
  * @remarks
4734
- * After you invoke CreateLaunchTemplate to create a template, Alibaba Cloud automatically generates a default version of the template with version number 1. You can subsequently create multiple versions based on this template by calling `CreateLaunchTemplateVersion`. Version numbers start from 1 and increment sequentially. If you do not specify a template version when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4735
- * A launch template version includes configurations required for instance creation, such as the Region, image ID, instance type, security group ID, and Internet bandwidth. If a particular configuration is not specified in the template version, you must provide it explicitly when creating the instance.
4736
- * When invoking this API, note the following:
4737
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
4738
- * - Most parameters in a launch template are optional. Alibaba Cloud does not validate the existence or validity of parameter values when you create the template. Validation occurs only when you actually create an instance.
4739
- * - If a configuration is set in the launch template, you cannot omit it when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template sets `HostName=LocalHost`, and you leave `HostName` empty in `RunInstances`, the instance hostname will still be `LocalHost`. To overwrite the `HostName=LocalHost` setting, specify a different value such as `HostName=MyHost` in `RunInstances`.
4732
+ * After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4733
+ * A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
4734
+ * When you call this operation, take note of the following items:
4735
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
4736
+ * - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
4737
+ * - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
4740
4738
  *
4741
4739
  * @param request - CreateLaunchTemplateRequest
4742
4740
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4930,15 +4928,15 @@ class Client extends openapi_core_1.default {
4930
4928
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLaunchTemplateResponse({}));
4931
4929
  }
4932
4930
  /**
4933
- * Create an ECS instance launch template, abbreviated as a template. An instance launch template eliminates the need to enter numerous configuration parameters each time you create an instance.
4931
+ * Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
4934
4932
  *
4935
4933
  * @remarks
4936
- * After you invoke CreateLaunchTemplate to create a template, Alibaba Cloud automatically generates a default version of the template with version number 1. You can subsequently create multiple versions based on this template by calling `CreateLaunchTemplateVersion`. Version numbers start from 1 and increment sequentially. If you do not specify a template version when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4937
- * A launch template version includes configurations required for instance creation, such as the Region, image ID, instance type, security group ID, and Internet bandwidth. If a particular configuration is not specified in the template version, you must provide it explicitly when creating the instance.
4938
- * When invoking this API, note the following:
4939
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
4940
- * - Most parameters in a launch template are optional. Alibaba Cloud does not validate the existence or validity of parameter values when you create the template. Validation occurs only when you actually create an instance.
4941
- * - If a configuration is set in the launch template, you cannot omit it when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template sets `HostName=LocalHost`, and you leave `HostName` empty in `RunInstances`, the instance hostname will still be `LocalHost`. To overwrite the `HostName=LocalHost` setting, specify a different value such as `HostName=MyHost` in `RunInstances`.
4934
+ * After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4935
+ * A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
4936
+ * When you call this operation, take note of the following items:
4937
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
4938
+ * - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
4939
+ * - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
4942
4940
  *
4943
4941
  * @param request - CreateLaunchTemplateRequest
4944
4942
  * @returns CreateLaunchTemplateResponse
@@ -12911,13 +12909,13 @@ class Client extends openapi_core_1.default {
12911
12909
  return await this.describeImageSupportInstanceTypesWithOptions(request, runtime);
12912
12910
  }
12913
12911
  /**
12914
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
12912
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
12915
12913
  *
12916
12914
  * @remarks
12917
- * - The image resources you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images actively shared with you by other Alibaba Cloud users.
12918
- * - Paged query is supported. The query results include the total number of usable image resources and the image resources on the current page. The default number of entries per page is 10.
12919
- * - When invoking the API through the Alibaba Cloud command-line interface (CLI), the values of request parameters of different data types must comply with format requirements. For more information, see [CLI Parameter Format Description](https://help.aliyun.com/document_detail/110340.html).
12920
- * - When querying official Alibaba Cloud images or shared images (where ImageOwnerAlias is set to system or others), RAM authentication rules are ignored for this request. For more information, see [Authentication Rules](https://help.aliyun.com/document_detail/25497.html).
12915
+ * - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
12916
+ * - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
12917
+ * - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
12918
+ * - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
12921
12919
  *
12922
12920
  * @param request - DescribeImagesRequest
12923
12921
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13024,13 +13022,13 @@ class Client extends openapi_core_1.default {
13024
13022
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeImagesResponse({}));
13025
13023
  }
13026
13024
  /**
13027
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
13025
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
13028
13026
  *
13029
13027
  * @remarks
13030
- * - The image resources you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images actively shared with you by other Alibaba Cloud users.
13031
- * - Paged query is supported. The query results include the total number of usable image resources and the image resources on the current page. The default number of entries per page is 10.
13032
- * - When invoking the API through the Alibaba Cloud command-line interface (CLI), the values of request parameters of different data types must comply with format requirements. For more information, see [CLI Parameter Format Description](https://help.aliyun.com/document_detail/110340.html).
13033
- * - When querying official Alibaba Cloud images or shared images (where ImageOwnerAlias is set to system or others), RAM authentication rules are ignored for this request. For more information, see [Authentication Rules](https://help.aliyun.com/document_detail/25497.html).
13028
+ * - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
13029
+ * - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
13030
+ * - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
13031
+ * - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
13034
13032
  *
13035
13033
  * @param request - DescribeImagesRequest
13036
13034
  * @returns DescribeImagesResponse
@@ -16190,7 +16188,7 @@ class Client extends openapi_core_1.default {
16190
16188
  return await this.describePriceWithOptions(request, runtime);
16191
16189
  }
16192
16190
  /**
16193
- * Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
16191
+ * (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
16194
16192
  *
16195
16193
  * @param request - DescribeRecommendInstanceTypeRequest
16196
16194
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16276,7 +16274,7 @@ class Client extends openapi_core_1.default {
16276
16274
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeRecommendInstanceTypeResponse({}));
16277
16275
  }
16278
16276
  /**
16279
- * Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
16277
+ * (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
16280
16278
  *
16281
16279
  * @param request - DescribeRecommendInstanceTypeRequest
16282
16280
  * @returns DescribeRecommendInstanceTypeResponse