@alicloud/ecs20140526 7.9.1 → 7.9.2

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 (64) hide show
  1. package/dist/client.d.ts +226 -220
  2. package/dist/client.js +229 -220
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AttachDiskRequest.d.ts +25 -27
  5. package/dist/models/AttachDiskRequest.js.map +1 -1
  6. package/dist/models/CancelAutoSnapshotPolicyRequest.d.ts +6 -9
  7. package/dist/models/CancelAutoSnapshotPolicyRequest.js.map +1 -1
  8. package/dist/models/CancelImagePipelineExecutionRequest.d.ts +1 -1
  9. package/dist/models/CloneDisksRequest.d.ts +10 -10
  10. package/dist/models/CopySnapshotRequest.d.ts +17 -18
  11. package/dist/models/CopySnapshotRequest.js.map +1 -1
  12. package/dist/models/CreateAutoSnapshotPolicyRequest.d.ts +29 -35
  13. package/dist/models/CreateAutoSnapshotPolicyRequest.js.map +1 -1
  14. package/dist/models/CreateAutoSnapshotPolicyResponseBody.d.ts +1 -1
  15. package/dist/models/CreateDiskRequest.d.ts +30 -30
  16. package/dist/models/CreateDiskResponseBody.d.ts +2 -2
  17. package/dist/models/CreateSnapshotGroupRequest.d.ts +23 -25
  18. package/dist/models/CreateSnapshotGroupRequest.js.map +1 -1
  19. package/dist/models/CreateSnapshotRequest.d.ts +24 -29
  20. package/dist/models/CreateSnapshotRequest.js.map +1 -1
  21. package/dist/models/DeleteSnapshotGroupRequest.d.ts +2 -2
  22. package/dist/models/DeleteSnapshotGroupResponseBody.d.ts +1 -1
  23. package/dist/models/DeleteSnapshotRequest.d.ts +2 -2
  24. package/dist/models/DescribeDiskDefaultKmskeyIdRequest.d.ts +1 -1
  25. package/dist/models/DescribeDiskDefaultKmskeyIdResponseBody.d.ts +1 -1
  26. package/dist/models/DescribeDiskEncryptionByDefaultStatusRequest.d.ts +1 -1
  27. package/dist/models/DescribeDiskEncryptionByDefaultStatusResponseBody.d.ts +5 -3
  28. package/dist/models/DescribeDiskEncryptionByDefaultStatusResponseBody.js.map +1 -1
  29. package/dist/models/DescribeImagesRequest.d.ts +21 -20
  30. package/dist/models/DescribeImagesRequest.js +2 -0
  31. package/dist/models/DescribeImagesRequest.js.map +1 -1
  32. package/dist/models/DescribeImagesResponseBody.d.ts +1 -0
  33. package/dist/models/DescribeImagesResponseBody.js +2 -0
  34. package/dist/models/DescribeImagesResponseBody.js.map +1 -1
  35. package/dist/models/DescribeSendFileResultsRequest.d.ts +13 -13
  36. package/dist/models/DescribeSnapshotGroupsRequest.d.ts +11 -11
  37. package/dist/models/DescribeSnapshotGroupsResponseBody.d.ts +3 -3
  38. package/dist/models/DisableDiskEncryptionByDefaultRequest.d.ts +1 -1
  39. package/package.json +1 -1
  40. package/src/client.ts +230 -220
  41. package/src/models/AttachDiskRequest.ts +25 -27
  42. package/src/models/CancelAutoSnapshotPolicyRequest.ts +6 -9
  43. package/src/models/CancelImagePipelineExecutionRequest.ts +1 -1
  44. package/src/models/CloneDisksRequest.ts +10 -10
  45. package/src/models/CopySnapshotRequest.ts +17 -18
  46. package/src/models/CreateAutoSnapshotPolicyRequest.ts +29 -35
  47. package/src/models/CreateAutoSnapshotPolicyResponseBody.ts +1 -1
  48. package/src/models/CreateDiskRequest.ts +30 -30
  49. package/src/models/CreateDiskResponseBody.ts +2 -2
  50. package/src/models/CreateSnapshotGroupRequest.ts +23 -25
  51. package/src/models/CreateSnapshotRequest.ts +24 -29
  52. package/src/models/DeleteSnapshotGroupRequest.ts +2 -2
  53. package/src/models/DeleteSnapshotGroupResponseBody.ts +1 -1
  54. package/src/models/DeleteSnapshotRequest.ts +2 -2
  55. package/src/models/DescribeDiskDefaultKmskeyIdRequest.ts +1 -1
  56. package/src/models/DescribeDiskDefaultKmskeyIdResponseBody.ts +1 -1
  57. package/src/models/DescribeDiskEncryptionByDefaultStatusRequest.ts +1 -1
  58. package/src/models/DescribeDiskEncryptionByDefaultStatusResponseBody.ts +5 -3
  59. package/src/models/DescribeImagesRequest.ts +23 -20
  60. package/src/models/DescribeImagesResponseBody.ts +3 -0
  61. package/src/models/DescribeSendFileResultsRequest.ts +13 -13
  62. package/src/models/DescribeSnapshotGroupsRequest.ts +11 -11
  63. package/src/models/DescribeSnapshotGroupsResponseBody.ts +3 -3
  64. package/src/models/DisableDiskEncryptionByDefaultRequest.ts +1 -1
package/dist/client.js CHANGED
@@ -1115,24 +1115,27 @@ class Client extends openapi_core_1.default {
1115
1115
  return await this.attachClassicLinkVpcWithOptions(request, runtime);
1116
1116
  }
1117
1117
  /**
1118
- * Attaches a pay-as-you-go data disk or a system disk to an Elastic Compute Service (ECS) instance.
1118
+ * Attaches a data disk or system disk to an ECS instance.
1119
1119
  *
1120
1120
  * @remarks
1121
- * Take note of the following items:
1122
- * - The ECS instance and the disk must reside in the same zone.
1123
- * - The disk must be in the **Unattached** (`Available`) state.
1124
- * - When you attach the disk as a data disk to an ECS instance, take note of the following items:
1125
- * - The ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
1126
- * - If the disk was separately purchased, the billing method of the disk must be pay-as-you-go.
1127
- * - If the disk is a system disk that was detached from an ECS instance, no limits apply to the billing method of the disk.
1128
- * - If the disk is an elastic ephemeral disk that was detached from an ECS instance, the disk can be attached only to the instance.
1129
- * - When you attach the disk as the system disk to an ECS instance, take note of the following items:
1130
- * - The ECS instance must be the original instance from which the system disk was detached.
1131
- * - The ECS instance must be in the **Stopped** (`Stopped`) state.
1132
- * - You must configure logon credentials for the ECS instance.
1133
- * - The disk cannot be an elastic ephemeral disk.
1134
- * - For more information about how to attach a system disk, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
1135
- * - If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query information about an ECS instance, the instance is locked for security reasons. No operations are allowed on the instance.
1121
+ * When you call this operation, take note of the following items:
1122
+ * - The instance and the disk must be in the same zone.
1123
+ * - The disk must be in the **Available** (`Available`) state.
1124
+ * - When you attach a data disk:
1125
+ * - The destination ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
1126
+ * - If the disk is separately purchased, the billing method must be pay-as-you-go.
1127
+ * - A system disk that was uninstalled from an ECS instance can be attached as a data disk without billable methods restrictions.
1128
+ * - An elastic ephemeral disk that has been detached can only be re-attached to its original instance.
1129
+ * - When you attach a system disk:
1130
+ * - The destination ECS instance must be the original instance from which the system disk was detached.
1131
+ * - The destination ECS instance must be in the **Stopped** (`Stopped`) state.
1132
+ * - You must specify the logon credential for the instance.
1133
+ * - Elastic ephemeral disks cannot be attached as system disks.
1134
+ * - For more information about attaching system disks, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
1135
+ * - When you query ECS instance information, if the response contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
1136
+ * <props="china">
1137
+ * - A disk with the multi-attach attribute enabled can only be attached to instances that support the NVMe protocol.
1138
+ * For more information, see [Standard SSDs that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1136
1139
  *
1137
1140
  * @param request - AttachDiskRequest
1138
1141
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1194,24 +1197,27 @@ class Client extends openapi_core_1.default {
1194
1197
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AttachDiskResponse({}));
1195
1198
  }
1196
1199
  /**
1197
- * Attaches a pay-as-you-go data disk or a system disk to an Elastic Compute Service (ECS) instance.
1200
+ * Attaches a data disk or system disk to an ECS instance.
1198
1201
  *
1199
1202
  * @remarks
1200
- * Take note of the following items:
1201
- * - The ECS instance and the disk must reside in the same zone.
1202
- * - The disk must be in the **Unattached** (`Available`) state.
1203
- * - When you attach the disk as a data disk to an ECS instance, take note of the following items:
1204
- * - The ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
1205
- * - If the disk was separately purchased, the billing method of the disk must be pay-as-you-go.
1206
- * - If the disk is a system disk that was detached from an ECS instance, no limits apply to the billing method of the disk.
1207
- * - If the disk is an elastic ephemeral disk that was detached from an ECS instance, the disk can be attached only to the instance.
1208
- * - When you attach the disk as the system disk to an ECS instance, take note of the following items:
1209
- * - The ECS instance must be the original instance from which the system disk was detached.
1210
- * - The ECS instance must be in the **Stopped** (`Stopped`) state.
1211
- * - You must configure logon credentials for the ECS instance.
1212
- * - The disk cannot be an elastic ephemeral disk.
1213
- * - For more information about how to attach a system disk, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
1214
- * - If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query information about an ECS instance, the instance is locked for security reasons. No operations are allowed on the instance.
1203
+ * When you call this operation, take note of the following items:
1204
+ * - The instance and the disk must be in the same zone.
1205
+ * - The disk must be in the **Available** (`Available`) state.
1206
+ * - When you attach a data disk:
1207
+ * - The destination ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
1208
+ * - If the disk is separately purchased, the billing method must be pay-as-you-go.
1209
+ * - A system disk that was uninstalled from an ECS instance can be attached as a data disk without billable methods restrictions.
1210
+ * - An elastic ephemeral disk that has been detached can only be re-attached to its original instance.
1211
+ * - When you attach a system disk:
1212
+ * - The destination ECS instance must be the original instance from which the system disk was detached.
1213
+ * - The destination ECS instance must be in the **Stopped** (`Stopped`) state.
1214
+ * - You must specify the logon credential for the instance.
1215
+ * - Elastic ephemeral disks cannot be attached as system disks.
1216
+ * - For more information about attaching system disks, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
1217
+ * - When you query ECS instance information, if the response contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
1218
+ * <props="china">
1219
+ * - A disk with the multi-attach attribute enabled can only be attached to instances that support the NVMe protocol.
1220
+ * For more information, see [Standard SSDs that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1215
1221
  *
1216
1222
  * @param request - AttachDiskRequest
1217
1223
  * @returns AttachDiskResponse
@@ -1877,7 +1883,7 @@ class Client extends openapi_core_1.default {
1877
1883
  return await this.authorizeSecurityGroupEgressWithOptions(request, runtime);
1878
1884
  }
1879
1885
  /**
1880
- * Cancels an auto snapshot policy for one or more disks.
1886
+ * Cancels the automatic snapshot policy for one or more cloud disks.
1881
1887
  *
1882
1888
  * @param request - CancelAutoSnapshotPolicyRequest
1883
1889
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1921,7 +1927,7 @@ class Client extends openapi_core_1.default {
1921
1927
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CancelAutoSnapshotPolicyResponse({}));
1922
1928
  }
1923
1929
  /**
1924
- * Cancels an auto snapshot policy for one or more disks.
1930
+ * Cancels the automatic snapshot policy for one or more cloud disks.
1925
1931
  *
1926
1932
  * @param request - CancelAutoSnapshotPolicyRequest
1927
1933
  * @returns CancelAutoSnapshotPolicyResponse
@@ -1995,10 +2001,10 @@ class Client extends openapi_core_1.default {
1995
2001
  return await this.cancelCopyImageWithOptions(request, runtime);
1996
2002
  }
1997
2003
  /**
1998
- * Cancels an image build task.
2004
+ * Cancels an image building task.
1999
2005
  *
2000
2006
  * @remarks
2001
- * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2007
+ * Before you call this operation, make sure that the image building task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2002
2008
  *
2003
2009
  * @param request - CancelImagePipelineExecutionRequest
2004
2010
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2048,10 +2054,10 @@ class Client extends openapi_core_1.default {
2048
2054
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CancelImagePipelineExecutionResponse({}));
2049
2055
  }
2050
2056
  /**
2051
- * Cancels an image build task.
2057
+ * Cancels an image building task.
2052
2058
  *
2053
2059
  * @remarks
2054
- * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2060
+ * Before you call this operation, make sure that the image building task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2055
2061
  *
2056
2062
  * @param request - CancelImagePipelineExecutionRequest
2057
2063
  * @returns CancelImagePipelineExecutionResponse
@@ -2234,28 +2240,28 @@ class Client extends openapi_core_1.default {
2234
2240
  return await this.cancelTaskWithOptions(request, runtime);
2235
2241
  }
2236
2242
  /**
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.
2243
+ * Disk cloning allows you to quickly replicate a disk with the same data as the source disk in the same zone. The cloned disk supports custom capacity, type, and encryption attributes. After you attach the cloned disk to an instance, you can quickly replicate business data or horizontally scale services.
2238
2244
  *
2239
2245
  * @remarks
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.
2246
+ * > The disk cloning feature itself is free of charge. However, 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, other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2247
+ * ### Usage notes
2248
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to query the execution result.
2243
2249
  * ### Features
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.
2250
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the cloned `new disk` supports only ESSD series disk types.
2251
+ * - Non-regional disks can be cloned only to non-regional types. Regional disks can be cloned only to regional disk types.
2246
2252
  * - 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.
2253
+ * - You can specify the `new disk` type and performance level during cloning.
2254
+ * - You can specify the `new disk` capacity during cloning. The new disk capacity must be greater than or equal to the `source disk` capacity.
2255
+ * - You can configure provisioned performance and performance burst for the `new disk` during cloning, provided that the destination disk type supports provisioned performance and performance burst.
2256
+ * - You can specify encryption or change the encryption key for the `new disk` during cloning. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2257
+ * - You can use a subscription disk as the `source disk` for cloning, even if the subscription disk has expired.
2258
+ * - The cloned `new disk` does not support reinitialization.
2259
+ * - Cloning does not support storage sets or dedicated block storage clusters. However, disks in these resources can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2254
2260
  * - `Source disk` status restrictions:
2255
2261
  * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2256
2262
  * - 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`.
2263
+ * - Disks undergoing specification changes cannot be used as the `source disk`.
2264
+ * - Disks undergoing expansion cannot be used as the `source disk`.
2259
2265
  * - 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
2266
  *
2261
2267
  * @param request - CloneDisksRequest
@@ -2336,28 +2342,28 @@ class Client extends openapi_core_1.default {
2336
2342
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CloneDisksResponse({}));
2337
2343
  }
2338
2344
  /**
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.
2345
+ * Disk cloning allows you to quickly replicate a disk with the same data as the source disk in the same zone. The cloned disk supports custom capacity, type, and encryption attributes. After you attach the cloned disk to an instance, you can quickly replicate business data or horizontally scale services.
2340
2346
  *
2341
2347
  * @remarks
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.
2348
+ * > The disk cloning feature itself is free of charge. However, 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, other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2349
+ * ### Usage notes
2350
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to query the execution result.
2345
2351
  * ### Features
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.
2352
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the cloned `new disk` supports only ESSD series disk types.
2353
+ * - Non-regional disks can be cloned only to non-regional types. Regional disks can be cloned only to regional disk types.
2348
2354
  * - 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.
2355
+ * - You can specify the `new disk` type and performance level during cloning.
2356
+ * - You can specify the `new disk` capacity during cloning. The new disk capacity must be greater than or equal to the `source disk` capacity.
2357
+ * - You can configure provisioned performance and performance burst for the `new disk` during cloning, provided that the destination disk type supports provisioned performance and performance burst.
2358
+ * - You can specify encryption or change the encryption key for the `new disk` during cloning. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2359
+ * - You can use a subscription disk as the `source disk` for cloning, even if the subscription disk has expired.
2360
+ * - The cloned `new disk` does not support reinitialization.
2361
+ * - Cloning does not support storage sets or dedicated block storage clusters. However, disks in these resources can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2356
2362
  * - `Source disk` status restrictions:
2357
2363
  * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2358
2364
  * - 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`.
2365
+ * - Disks undergoing specification changes cannot be used as the `source disk`.
2366
+ * - Disks undergoing expansion cannot be used as the `source disk`.
2361
2367
  * - 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
2368
  *
2363
2369
  * @param request - CloneDisksRequest
@@ -2601,11 +2607,11 @@ class Client extends openapi_core_1.default {
2601
2607
  return await this.copyImageWithOptions(request, runtime);
2602
2608
  }
2603
2609
  /**
2604
- * Copies a standard or encrypted snapshot from one region to another.
2610
+ * Copies a standard snapshot or encrypted snapshot from one region to another.
2605
2611
  *
2606
2612
  * @remarks
2607
- * When you call this operation, take note of the following item:
2608
- * - New snapshots (snapshot copies) cannot be used to roll back the disks for which source snapshots (copied snapshots) were created.
2613
+ * When you call this operation, take note of the following items:
2614
+ * - The new snapshot cannot be used to roll back the cloud disk that is associated with the source snapshot.
2609
2615
  * - Local snapshots cannot be copied.
2610
2616
  *
2611
2617
  * @param request - CopySnapshotRequest
@@ -2680,11 +2686,11 @@ class Client extends openapi_core_1.default {
2680
2686
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CopySnapshotResponse({}));
2681
2687
  }
2682
2688
  /**
2683
- * Copies a standard or encrypted snapshot from one region to another.
2689
+ * Copies a standard snapshot or encrypted snapshot from one region to another.
2684
2690
  *
2685
2691
  * @remarks
2686
- * When you call this operation, take note of the following item:
2687
- * - New snapshots (snapshot copies) cannot be used to roll back the disks for which source snapshots (copied snapshots) were created.
2692
+ * When you call this operation, take note of the following items:
2693
+ * - The new snapshot cannot be used to roll back the cloud disk that is associated with the source snapshot.
2688
2694
  * - Local snapshots cannot be copied.
2689
2695
  *
2690
2696
  * @param request - CopySnapshotRequest
@@ -2969,15 +2975,15 @@ class Client extends openapi_core_1.default {
2969
2975
  return await this.createAutoProvisioningGroupWithOptions(request, runtime);
2970
2976
  }
2971
2977
  /**
2972
- * Creates an automatic snapshot policy in a specific region. You can specify the schedule on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the automatic snapshot policy. The automatic snapshot policy can be applied to create snapshots for system disks or data disks to back up disk data.
2978
+ * Creates an automatic snapshot policy in a specified region. You can specify the repeat cycle, retention period, and cross-region backup settings for automatic snapshots to back up data on system disks or data disks.
2973
2979
  *
2974
2980
  * @remarks
2975
- * Before you call this operation, learn about how to [create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
2981
+ * Before you call this operation, read [Create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
2976
2982
  * Take note of the following items:
2977
- * - You can create up to 100 automatic snapshot policies per region for a single Alibaba Cloud account. If the maximum number of automatic snapshots for a disk is reached and a new snapshot creation task is created, the system deletes the oldest automatic snapshot of the disk.
2978
- * - If the instance to which a disk is attached is being stopped or restarted, the system cannot create snapshots for the disk based on the associated automatic snapshot policy.
2979
- * - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are copied to the destination region and snapshot copies are encrypted by using the service key of the destination region. For more information about the limits on cross-region snapshot replication, see [Copy a snapshot](https://help.aliyun.com/document_detail/159441.html).
2980
- * After the automatic snapshot policy is created, call the [ApplyAutoSnapshotPolicy](https://help.aliyun.com/document_detail/25531.html) operation to apply the policy to disks. If you want to modify the automatic snapshot policy, call the [ModifyAutoSnapshotPolicyEx](https://help.aliyun.com/document_detail/25529.html) operation.
2983
+ * - You can create a maximum of 100 automatic snapshot policies in a region for an Alibaba Cloud account. When the number of automatic snapshots for a disk reaches the quota limit, the system deletes the earliest automatic snapshot created by the automatic snapshot policy when a new snapshot task is initiated.
2984
+ * - The system does not execute automatic snapshot policies when an ECS instance has a pending stop or restart task.
2985
+ * - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are replicated to the destination region by using the service key of the destination region by default. For more information about cross-region snapshot replication, see [Copy a snapshot](https://help.aliyun.com/document_detail/159441.html).
2986
+ * After you create an automatic snapshot policy, call [ApplyAutoSnapshotPolicy](https://help.aliyun.com/document_detail/25531.html) to apply the policy to disks. To modify an automatic snapshot policy, call [ModifyAutoSnapshotPolicyEx](https://help.aliyun.com/document_detail/25529.html).
2981
2987
  *
2982
2988
  * @param request - CreateAutoSnapshotPolicyRequest
2983
2989
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3048,15 +3054,15 @@ class Client extends openapi_core_1.default {
3048
3054
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoSnapshotPolicyResponse({}));
3049
3055
  }
3050
3056
  /**
3051
- * Creates an automatic snapshot policy in a specific region. You can specify the schedule on which to create automatic snapshots, the retention period of the automatic snapshots, and whether to enable cross-region replication for the snapshots in the automatic snapshot policy. The automatic snapshot policy can be applied to create snapshots for system disks or data disks to back up disk data.
3057
+ * Creates an automatic snapshot policy in a specified region. You can specify the repeat cycle, retention period, and cross-region backup settings for automatic snapshots to back up data on system disks or data disks.
3052
3058
  *
3053
3059
  * @remarks
3054
- * Before you call this operation, learn about how to [create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
3060
+ * Before you call this operation, read [Create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
3055
3061
  * Take note of the following items:
3056
- * - You can create up to 100 automatic snapshot policies per region for a single Alibaba Cloud account. If the maximum number of automatic snapshots for a disk is reached and a new snapshot creation task is created, the system deletes the oldest automatic snapshot of the disk.
3057
- * - If the instance to which a disk is attached is being stopped or restarted, the system cannot create snapshots for the disk based on the associated automatic snapshot policy.
3058
- * - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are copied to the destination region and snapshot copies are encrypted by using the service key of the destination region. For more information about the limits on cross-region snapshot replication, see [Copy a snapshot](https://help.aliyun.com/document_detail/159441.html).
3059
- * After the automatic snapshot policy is created, call the [ApplyAutoSnapshotPolicy](https://help.aliyun.com/document_detail/25531.html) operation to apply the policy to disks. If you want to modify the automatic snapshot policy, call the [ModifyAutoSnapshotPolicyEx](https://help.aliyun.com/document_detail/25529.html) operation.
3062
+ * - You can create a maximum of 100 automatic snapshot policies in a region for an Alibaba Cloud account. When the number of automatic snapshots for a disk reaches the quota limit, the system deletes the earliest automatic snapshot created by the automatic snapshot policy when a new snapshot task is initiated.
3063
+ * - The system does not execute automatic snapshot policies when an ECS instance has a pending stop or restart task.
3064
+ * - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are replicated to the destination region by using the service key of the destination region by default. For more information about cross-region snapshot replication, see [Copy a snapshot](https://help.aliyun.com/document_detail/159441.html).
3065
+ * After you create an automatic snapshot policy, call [ApplyAutoSnapshotPolicy](https://help.aliyun.com/document_detail/25531.html) to apply the policy to disks. To modify an automatic snapshot policy, call [ModifyAutoSnapshotPolicyEx](https://help.aliyun.com/document_detail/25529.html).
3060
3066
  *
3061
3067
  * @param request - CreateAutoSnapshotPolicyRequest
3062
3068
  * @returns CreateAutoSnapshotPolicyResponse
@@ -3559,14 +3565,14 @@ class Client extends openapi_core_1.default {
3559
3565
  * Creates a pay-as-you-go or subscription data disk.
3560
3566
  *
3561
3567
  * @remarks
3562
- * - When you create a disk, you can enable the multi-attach feature (`MultiAttach`). Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
3568
+ * - You can enable the multi-attach attribute (`MultiAttach`) when you create a disk. Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
3563
3569
  * - The following disk types can be created: basic disks, ultra disks, standard SSDs, enterprise SSDs, ESSD Entry disks, regional Enterprise SSDs (ESSDs), ESSD AutoPL disks, elastic ephemeral disks - Standard Edition, and elastic ephemeral disks - Premium Edition.
3564
- * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
3565
- * - Creating a disk incurs fees. Learn about the billing method of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
3570
+ * - Complete real-name registration before you create a disk. Go to [Real-name registration](https://account.console.aliyun.com/#/auth/home) in your account information.
3571
+ * - Creating a disk incurs charges. Learn about the billing methods of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
3566
3572
  * - Default settings when you create a disk:
3567
- * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
3568
- * - When you create an enterprise SSD, if you do not configure a performance level, the default level is PL1. You can call [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
3569
- * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
3573
+ * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can invoke [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
3574
+ * - When you create an enterprise SSD, if you do not configure the performance level, the default level is PL1. You can invoke [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
3575
+ * - The billing method is pay-as-you-go. That is, the `Portable` property defaults to `true`.
3570
3576
  *
3571
3577
  * @param request - CreateDiskRequest
3572
3578
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3676,14 +3682,14 @@ class Client extends openapi_core_1.default {
3676
3682
  * Creates a pay-as-you-go or subscription data disk.
3677
3683
  *
3678
3684
  * @remarks
3679
- * - When you create a disk, you can enable the multi-attach feature (`MultiAttach`). Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
3685
+ * - You can enable the multi-attach attribute (`MultiAttach`) when you create a disk. Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
3680
3686
  * - The following disk types can be created: basic disks, ultra disks, standard SSDs, enterprise SSDs, ESSD Entry disks, regional Enterprise SSDs (ESSDs), ESSD AutoPL disks, elastic ephemeral disks - Standard Edition, and elastic ephemeral disks - Premium Edition.
3681
- * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
3682
- * - Creating a disk incurs fees. Learn about the billing method of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
3687
+ * - Complete real-name registration before you create a disk. Go to [Real-name registration](https://account.console.aliyun.com/#/auth/home) in your account information.
3688
+ * - Creating a disk incurs charges. Learn about the billing methods of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
3683
3689
  * - Default settings when you create a disk:
3684
- * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
3685
- * - When you create an enterprise SSD, if you do not configure a performance level, the default level is PL1. You can call [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
3686
- * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
3690
+ * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can invoke [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
3691
+ * - When you create an enterprise SSD, if you do not configure the performance level, the default level is PL1. You can invoke [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
3692
+ * - The billing method is pay-as-you-go. That is, the `Portable` property defaults to `true`.
3687
3693
  *
3688
3694
  * @param request - CreateDiskRequest
3689
3695
  * @returns CreateDiskResponse
@@ -6258,30 +6264,30 @@ class Client extends openapi_core_1.default {
6258
6264
  return await this.createSimulatedSystemEventsWithOptions(request, runtime);
6259
6265
  }
6260
6266
  /**
6261
- * Create a snapshot of a cloud disk.
6262
- *
6263
- * @remarks
6264
- * The instant access feature for snapshots replaces the legacy local snapshot feature. The parameters are described as follows:
6265
- * - If you used local snapshots before December 14, 2020, you can continue to use the `Category` parameter.
6266
- * - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots that are created for ESSD cloud disks (ESSDs, ESSD AutoPL disks, ESSD Entry disks, and zone-redundant ESSDs) have the instant access feature enabled by default. This applies to both manual and automatic snapshots. The instant access-related parameters `InstantAccess`, `InstantAccessRetentionDays`, and `DisableInstantAccess` no longer take effect. The `DescribeSnapshots` and `DescribeSnapshotGroups` API operations return an `Available` parameter that indicates the snapshot\\"s status.
6267
- * Prerequisites:
6268
- * - The snapshot feature is enabled. For more information, see [Enable the snapshot feature](https://help.aliyun.com/document_detail/108381.html).
6269
- * - The cloud disk must be in the **in-use** or **available** state. Note the following points:
6270
- * - If the cloud disk is in the **in-use** state, the instance to which the disk is attached must be in the **running** or **stopped** state.
6271
- * - If the cloud disk is in the **available** state, you can create snapshots for it only if it has been previously attached to an ECS instance.
6272
- * - When you use cloud disks to create dynamic scalable volumes or RAID arrays, we recommend that you use snapshot consistency groups and enable application-consistent snapshots to back up data. A snapshot consistency group ensures the crash consistency and write-order consistency of data written across multiple cloud disks. For more information, see [Create a snapshot consistency group](https://help.aliyun.com/document_detail/199625.html) and [Create an application-consistent snapshot](https://help.aliyun.com/document_detail/208589.html).
6273
- * Keep the following in mind when creating a snapshot:
6274
- * - Create snapshots during off-peak hours. During snapshot creation, the I/O performance of the cloud disk decreases by less than 10% and read and write operations may temporarily slow down.
6275
- * - You cannot use a snapshot that is being created to create a custom image ([CreateImage](https://help.aliyun.com/document_detail/25535.html)).
6276
- * - The snapshot does not back up incremental data generated on the cloud disk during the creation process.
6277
- * - If the cloud disk is attached to an ECS instance, do not change the state of the instance, such as stopping or restarting the instance, during snapshot creation. Otherwise, the snapshot creation will fail.
6278
- * - You cannot resize a cloud disk during snapshot creation. You can resize the cloud disk only after the snapshot is complete.
6279
- * - You can create a snapshot for a cloud disk that is in the **expired** (`Expired`) state. If the cloud disk is released due to expiration when the snapshot is being created, the snapshot in the **creating** (`Creating`) state is also deleted.
6280
- * - After a snapshot is created, you are charged for the snapshot based on its size. The fees are settled on a per-region basis. For more information, see [Snapshots](https://help.aliyun.com/document_detail/56159.html).
6281
- * - You cannot create a snapshot for a cloud disk in the following cases:
6282
- * - The number of manual snapshots of the cloud disk has reached the upper limit. For more information, see [Limits](~~25412#SnapshotQuota1~~).
6283
- * - The limit on the number of snapshots that can be created concurrently has been reached. For more information, see [Limits](~~25412#SnapshotQuota1~~).
6284
- * - When you query the information of an ECS instance, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations on the instance are prohibited.
6267
+ * Creates a snapshot for a disk.
6268
+ *
6269
+ * @remarks
6270
+ * The local snapshot feature has been replaced by the snapshot instant access feature. Metric description is as follows:
6271
+ * - If you used local snapshots before December 14, 2020, you can use the `Category` parameter as Normal.
6272
+ * - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots created for ESSD series disks (ESSD, ESSD AutoPL, ESSD Entry, and regional ESSD) are instantly active by default, and both manual snapshots and automatic snapshots are supported. The three snapshot instant access-related parameters `InstantAccess`, `InstantAccessRetentionDays`, and `DisableInstantAccess` in API operations no longer take effect. The `DescribeSnapshots` and `DescribeSnapshotGroups` API operations will include a new response parameter named Available to describe the active status of snapshots.
6273
+ * Before you begin:
6274
+ * - Activate the snapshot feature. For more information, see [Activate snapshots](https://help.aliyun.com/document_detail/108381.html).
6275
+ * - The disk must be in the **In Use** or **Unattached** state. Note the following items for different states:
6276
+ * - If the disk is in the **In Use** state, the instance must be in the **Running** or **Stopped** state.
6277
+ * - If the disk is in the **Unattached** state, the disk must have been previously attached to an ECS instance. Snapshots cannot be created for disks that have never been attached to an ECS instance.
6278
+ * - When a disk is used to create a dynamic extended volume or a RAID array, use a snapshot-consistent group and enable application-consistent snapshots to back up data. Snapshot-consistent groups ensure write order consistency and crash consistency for data written to multiple disks in a business system. For more information, see [Create a snapshot-consistent group](https://help.aliyun.com/document_detail/199625.html) and [Create an application-consistent snapshot](https://help.aliyun.com/document_detail/208589.html).
6279
+ * When you create a snapshot, take note of the following items:
6280
+ * - Avoid creating snapshots during peak business hours. When a snapshot is being created, the I/O performance of the disk decreases by up to 10%, and read and write performance may be briefly affected.
6281
+ * - If the snapshot has not been created, it cannot be used to create a custom image ([CreateImage](https://help.aliyun.com/document_detail/25535.html)).
6282
+ * - Incremental data generated by disk operations during snapshot creation is not backup to the snapshot.
6283
+ * - If the disk is attached to an ECS instance, do not change the instance status during snapshot creation, such as stopping or restarting the ECS instance. Otherwise, the snapshot creation is failed.
6284
+ * - A disk for which a snapshot is being created does not support scale-out. Wait until the snapshot is created before you execute the scale-out operation.
6285
+ * - You can create snapshots for disks in the **Expired** (`Expired`) state. If the disk reaches its expiration release time during snapshot creation, the disk is released and the snapshot in the **Creating** (`Creating`) state is also deleted.
6286
+ * - After a snapshot is created, the system calculates fees based on the snapshot size in each region separately. For more information, see [Snapshot billing](https://help.aliyun.com/document_detail/56159.html).
6287
+ * - In the following scenarios, you cannot create a snapshot for the specified disk:
6288
+ * - The number of manual snapshots retained for the disk has reached the upper limit. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
6289
+ * - Snapshot creation has concurrency limits. Exceeding the limits causes creation failures. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
6290
+ * - When you query ECS instance information, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
6285
6291
  *
6286
6292
  * @param request - CreateSnapshotRequest
6287
6293
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6352,30 +6358,30 @@ class Client extends openapi_core_1.default {
6352
6358
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateSnapshotResponse({}));
6353
6359
  }
6354
6360
  /**
6355
- * Create a snapshot of a cloud disk.
6356
- *
6357
- * @remarks
6358
- * The instant access feature for snapshots replaces the legacy local snapshot feature. The parameters are described as follows:
6359
- * - If you used local snapshots before December 14, 2020, you can continue to use the `Category` parameter.
6360
- * - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots that are created for ESSD cloud disks (ESSDs, ESSD AutoPL disks, ESSD Entry disks, and zone-redundant ESSDs) have the instant access feature enabled by default. This applies to both manual and automatic snapshots. The instant access-related parameters `InstantAccess`, `InstantAccessRetentionDays`, and `DisableInstantAccess` no longer take effect. The `DescribeSnapshots` and `DescribeSnapshotGroups` API operations return an `Available` parameter that indicates the snapshot\\"s status.
6361
- * Prerequisites:
6362
- * - The snapshot feature is enabled. For more information, see [Enable the snapshot feature](https://help.aliyun.com/document_detail/108381.html).
6363
- * - The cloud disk must be in the **in-use** or **available** state. Note the following points:
6364
- * - If the cloud disk is in the **in-use** state, the instance to which the disk is attached must be in the **running** or **stopped** state.
6365
- * - If the cloud disk is in the **available** state, you can create snapshots for it only if it has been previously attached to an ECS instance.
6366
- * - When you use cloud disks to create dynamic scalable volumes or RAID arrays, we recommend that you use snapshot consistency groups and enable application-consistent snapshots to back up data. A snapshot consistency group ensures the crash consistency and write-order consistency of data written across multiple cloud disks. For more information, see [Create a snapshot consistency group](https://help.aliyun.com/document_detail/199625.html) and [Create an application-consistent snapshot](https://help.aliyun.com/document_detail/208589.html).
6367
- * Keep the following in mind when creating a snapshot:
6368
- * - Create snapshots during off-peak hours. During snapshot creation, the I/O performance of the cloud disk decreases by less than 10% and read and write operations may temporarily slow down.
6369
- * - You cannot use a snapshot that is being created to create a custom image ([CreateImage](https://help.aliyun.com/document_detail/25535.html)).
6370
- * - The snapshot does not back up incremental data generated on the cloud disk during the creation process.
6371
- * - If the cloud disk is attached to an ECS instance, do not change the state of the instance, such as stopping or restarting the instance, during snapshot creation. Otherwise, the snapshot creation will fail.
6372
- * - You cannot resize a cloud disk during snapshot creation. You can resize the cloud disk only after the snapshot is complete.
6373
- * - You can create a snapshot for a cloud disk that is in the **expired** (`Expired`) state. If the cloud disk is released due to expiration when the snapshot is being created, the snapshot in the **creating** (`Creating`) state is also deleted.
6374
- * - After a snapshot is created, you are charged for the snapshot based on its size. The fees are settled on a per-region basis. For more information, see [Snapshots](https://help.aliyun.com/document_detail/56159.html).
6375
- * - You cannot create a snapshot for a cloud disk in the following cases:
6376
- * - The number of manual snapshots of the cloud disk has reached the upper limit. For more information, see [Limits](~~25412#SnapshotQuota1~~).
6377
- * - The limit on the number of snapshots that can be created concurrently has been reached. For more information, see [Limits](~~25412#SnapshotQuota1~~).
6378
- * - When you query the information of an ECS instance, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations on the instance are prohibited.
6361
+ * Creates a snapshot for a disk.
6362
+ *
6363
+ * @remarks
6364
+ * The local snapshot feature has been replaced by the snapshot instant access feature. Metric description is as follows:
6365
+ * - If you used local snapshots before December 14, 2020, you can use the `Category` parameter as Normal.
6366
+ * - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots created for ESSD series disks (ESSD, ESSD AutoPL, ESSD Entry, and regional ESSD) are instantly active by default, and both manual snapshots and automatic snapshots are supported. The three snapshot instant access-related parameters `InstantAccess`, `InstantAccessRetentionDays`, and `DisableInstantAccess` in API operations no longer take effect. The `DescribeSnapshots` and `DescribeSnapshotGroups` API operations will include a new response parameter named Available to describe the active status of snapshots.
6367
+ * Before you begin:
6368
+ * - Activate the snapshot feature. For more information, see [Activate snapshots](https://help.aliyun.com/document_detail/108381.html).
6369
+ * - The disk must be in the **In Use** or **Unattached** state. Note the following items for different states:
6370
+ * - If the disk is in the **In Use** state, the instance must be in the **Running** or **Stopped** state.
6371
+ * - If the disk is in the **Unattached** state, the disk must have been previously attached to an ECS instance. Snapshots cannot be created for disks that have never been attached to an ECS instance.
6372
+ * - When a disk is used to create a dynamic extended volume or a RAID array, use a snapshot-consistent group and enable application-consistent snapshots to back up data. Snapshot-consistent groups ensure write order consistency and crash consistency for data written to multiple disks in a business system. For more information, see [Create a snapshot-consistent group](https://help.aliyun.com/document_detail/199625.html) and [Create an application-consistent snapshot](https://help.aliyun.com/document_detail/208589.html).
6373
+ * When you create a snapshot, take note of the following items:
6374
+ * - Avoid creating snapshots during peak business hours. When a snapshot is being created, the I/O performance of the disk decreases by up to 10%, and read and write performance may be briefly affected.
6375
+ * - If the snapshot has not been created, it cannot be used to create a custom image ([CreateImage](https://help.aliyun.com/document_detail/25535.html)).
6376
+ * - Incremental data generated by disk operations during snapshot creation is not backup to the snapshot.
6377
+ * - If the disk is attached to an ECS instance, do not change the instance status during snapshot creation, such as stopping or restarting the ECS instance. Otherwise, the snapshot creation is failed.
6378
+ * - A disk for which a snapshot is being created does not support scale-out. Wait until the snapshot is created before you execute the scale-out operation.
6379
+ * - You can create snapshots for disks in the **Expired** (`Expired`) state. If the disk reaches its expiration release time during snapshot creation, the disk is released and the snapshot in the **Creating** (`Creating`) state is also deleted.
6380
+ * - After a snapshot is created, the system calculates fees based on the snapshot size in each region separately. For more information, see [Snapshot billing](https://help.aliyun.com/document_detail/56159.html).
6381
+ * - In the following scenarios, you cannot create a snapshot for the specified disk:
6382
+ * - The number of manual snapshots retained for the disk has reached the upper limit. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
6383
+ * - Snapshot creation has concurrency limits. Exceeding the limits causes creation failures. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
6384
+ * - When you query ECS instance information, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
6379
6385
  *
6380
6386
  * @param request - CreateSnapshotRequest
6381
6387
  * @returns CreateSnapshotResponse
@@ -6385,20 +6391,20 @@ class Client extends openapi_core_1.default {
6385
6391
  return await this.createSnapshotWithOptions(request, runtime);
6386
6392
  }
6387
6393
  /**
6388
- * Creates a snapshot-consistent group for the disks of an Elastic Compute Service (ECS) instance. A snapshot-consistent group contains snapshots of one or more disks.
6394
+ * Creates a snapshot-consistent group for disks attached to a specified ECS instance. A snapshot-consistent group contains snapshots of one or more disks.
6389
6395
  *
6390
6396
  * @remarks
6391
- * 您可以设置`InstanceId`为实例内的指定云盘创建快照一致性组;也可以只使用`DiskId.N`为同可用区内多台 ECS 实例挂载的多块云盘创建快照一致性组。
6392
- * > `DiskId.N`不可与`ExcludeDiskId.N`同时设置。此外,如果设置了`InstanceId`,则`DiskId.N`只能设置指定实例内已挂载的云盘,不再支持设置多个跨实例的云盘 ID。
6393
- * 创建快照一致性组时,请注意:
6394
- * - 待创建快照的云盘必须处于**使用中**(`In_use`)或**待挂载**(`Available`)的状态。
6395
- * - 如果云盘处于**使用中**(`In_use`)的状态,则 ECS 实例状态为**运行中**(`Running`)或者**已停止**(`Stopped`)。
6396
- * - 如果云盘处于**待挂载**(`Available`)的状态,则需要保证云盘有过挂载到 ECS 实例的历史操作。从未挂载过 ECS 实例的云盘不支持创建快照。
6397
- * - 目前快照一致性组只支持 ESSD 系列云盘(ESSDESSD AutoPLESSD Entry)。
6398
- * - 单个快照一致性组最多包括 16 块云盘(包括系统盘和数据盘),且总容量不超过 32 TiB
6399
- * - 您自行创建的快照会一直保留,请定期删除不再需要的快照,避免快照容量持续扣费。
6400
- * - 开启多重挂载特性的云盘不支持创建快照一致性组。如果实例挂载了开启多重挂载特性的云盘,您需要设置`ExcludeDiskId.N`参数排除该云盘。
6401
- * 关于快照一致性组的功能、计费等信息,请参见[快照一致性组](https://help.aliyun.com/document_detail/199625.html)
6397
+ * You can set `InstanceId` to create a snapshot-consistent group for specified disks within an instance. Alternatively, you can use only `DiskId.N` to create a snapshot-consistent group for multiple disks attached to multiple ECS instances in the same zone.
6398
+ * > `DiskId.N` and `ExcludeDiskId.N` cannot be specified at the same time. If `InstanceId` is specified, `DiskId.N` can only be set to disks attached to the specified instance and no longer supports specifying disk IDs across multiple instances.
6399
+ * When you create a snapshot-consistent group, take note of the following items:
6400
+ * - The disks for which you want to create snapshots must be in the **In Use** (`In_use`) or **Available** (`Available`) state.
6401
+ * - If a disk is in the **In Use** (`In_use`) state, the ECS instance status must be **Running** (`Running`) or **Stopped** (`Stopped`).
6402
+ * - If a disk is in the **Available** (`Available`) state, the disk must have been previously attached to an ECS instance. Disks that have never been attached to an ECS instance do not support snapshot creation.
6403
+ * - Snapshot-consistent groups support only ESSD series disks (ESSD, ESSD AutoPL, and ESSD Entry).
6404
+ * - A single snapshot-consistent group can contain up to 16 disks (including system disks and data disks), and the total capacity cannot exceed 32 TiB.
6405
+ * - Snapshots that you manually create are retained until you delete them. Delete unnecessary snapshots on a regular basis to avoid incurring ongoing snapshot size fees.
6406
+ * - Disks with the multi-attach attribute enabled do not support snapshot-consistent groups. If an instance has a multi-attach disk attached, set the `ExcludeDiskId.N` parameter to exclude the disk.
6407
+ * For more information about the features and billing of snapshot-consistent groups, see [Snapshot-consistent groups](https://help.aliyun.com/document_detail/199625.html).
6402
6408
  *
6403
6409
  * @param request - CreateSnapshotGroupRequest
6404
6410
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6472,20 +6478,20 @@ class Client extends openapi_core_1.default {
6472
6478
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateSnapshotGroupResponse({}));
6473
6479
  }
6474
6480
  /**
6475
- * Creates a snapshot-consistent group for the disks of an Elastic Compute Service (ECS) instance. A snapshot-consistent group contains snapshots of one or more disks.
6481
+ * Creates a snapshot-consistent group for disks attached to a specified ECS instance. A snapshot-consistent group contains snapshots of one or more disks.
6476
6482
  *
6477
6483
  * @remarks
6478
- * 您可以设置`InstanceId`为实例内的指定云盘创建快照一致性组;也可以只使用`DiskId.N`为同可用区内多台 ECS 实例挂载的多块云盘创建快照一致性组。
6479
- * > `DiskId.N`不可与`ExcludeDiskId.N`同时设置。此外,如果设置了`InstanceId`,则`DiskId.N`只能设置指定实例内已挂载的云盘,不再支持设置多个跨实例的云盘 ID。
6480
- * 创建快照一致性组时,请注意:
6481
- * - 待创建快照的云盘必须处于**使用中**(`In_use`)或**待挂载**(`Available`)的状态。
6482
- * - 如果云盘处于**使用中**(`In_use`)的状态,则 ECS 实例状态为**运行中**(`Running`)或者**已停止**(`Stopped`)。
6483
- * - 如果云盘处于**待挂载**(`Available`)的状态,则需要保证云盘有过挂载到 ECS 实例的历史操作。从未挂载过 ECS 实例的云盘不支持创建快照。
6484
- * - 目前快照一致性组只支持 ESSD 系列云盘(ESSDESSD AutoPLESSD Entry)。
6485
- * - 单个快照一致性组最多包括 16 块云盘(包括系统盘和数据盘),且总容量不超过 32 TiB
6486
- * - 您自行创建的快照会一直保留,请定期删除不再需要的快照,避免快照容量持续扣费。
6487
- * - 开启多重挂载特性的云盘不支持创建快照一致性组。如果实例挂载了开启多重挂载特性的云盘,您需要设置`ExcludeDiskId.N`参数排除该云盘。
6488
- * 关于快照一致性组的功能、计费等信息,请参见[快照一致性组](https://help.aliyun.com/document_detail/199625.html)
6484
+ * You can set `InstanceId` to create a snapshot-consistent group for specified disks within an instance. Alternatively, you can use only `DiskId.N` to create a snapshot-consistent group for multiple disks attached to multiple ECS instances in the same zone.
6485
+ * > `DiskId.N` and `ExcludeDiskId.N` cannot be specified at the same time. If `InstanceId` is specified, `DiskId.N` can only be set to disks attached to the specified instance and no longer supports specifying disk IDs across multiple instances.
6486
+ * When you create a snapshot-consistent group, take note of the following items:
6487
+ * - The disks for which you want to create snapshots must be in the **In Use** (`In_use`) or **Available** (`Available`) state.
6488
+ * - If a disk is in the **In Use** (`In_use`) state, the ECS instance status must be **Running** (`Running`) or **Stopped** (`Stopped`).
6489
+ * - If a disk is in the **Available** (`Available`) state, the disk must have been previously attached to an ECS instance. Disks that have never been attached to an ECS instance do not support snapshot creation.
6490
+ * - Snapshot-consistent groups support only ESSD series disks (ESSD, ESSD AutoPL, and ESSD Entry).
6491
+ * - A single snapshot-consistent group can contain up to 16 disks (including system disks and data disks), and the total capacity cannot exceed 32 TiB.
6492
+ * - Snapshots that you manually create are retained until you delete them. Delete unnecessary snapshots on a regular basis to avoid incurring ongoing snapshot size fees.
6493
+ * - Disks with the multi-attach attribute enabled do not support snapshot-consistent groups. If an instance has a multi-attach disk attached, set the `ExcludeDiskId.N` parameter to exclude the disk.
6494
+ * For more information about the features and billing of snapshot-consistent groups, see [Snapshot-consistent groups](https://help.aliyun.com/document_detail/199625.html).
6489
6495
  *
6490
6496
  * @param request - CreateSnapshotGroupRequest
6491
6497
  * @returns CreateSnapshotGroupResponse
@@ -7431,13 +7437,13 @@ class Client extends openapi_core_1.default {
7431
7437
  return await this.deleteDiagnosticReportsWithOptions(request, runtime);
7432
7438
  }
7433
7439
  /**
7434
- * Releases a pay-as-you-go data disk. Supported disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs (ESSDs).
7440
+ * Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
7435
7441
  *
7436
7442
  * @remarks
7437
7443
  * When you invoke this operation, take note of the following items:
7438
7444
  * - Manual snapshots of the disk are retained.
7439
- * - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to specify whether to retain or release automatic snapshots along with the disk. Delete unnecessary snapshots promptly to maintain sufficient snapshot quota for epoch-based automatic snapshot policy execution.
7440
- * - The disk must be in the **Unattached** (Available) state when you release it.
7445
+ * - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to configure the Settings for whether to retain or release automatic snapshots together with the disk. Delete unnecessary snapshots promptly to maintain sufficient snapshot quota for epoch-based automatic snapshot policy.
7446
+ * - The disk must be in the Pending Attach (Available) state when you release it.
7441
7447
  * - If the disk with the specified ID does not exist, the request is ignored.
7442
7448
  *
7443
7449
  * @param request - DeleteDiskRequest
@@ -7479,13 +7485,13 @@ class Client extends openapi_core_1.default {
7479
7485
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteDiskResponse({}));
7480
7486
  }
7481
7487
  /**
7482
- * Releases a pay-as-you-go data disk. Supported disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs (ESSDs).
7488
+ * Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
7483
7489
  *
7484
7490
  * @remarks
7485
7491
  * When you invoke this operation, take note of the following items:
7486
7492
  * - Manual snapshots of the disk are retained.
7487
- * - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to specify whether to retain or release automatic snapshots along with the disk. Delete unnecessary snapshots promptly to maintain sufficient snapshot quota for epoch-based automatic snapshot policy execution.
7488
- * - The disk must be in the **Unattached** (Available) state when you release it.
7493
+ * - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to configure the Settings for whether to retain or release automatic snapshots together with the disk. Delete unnecessary snapshots promptly to maintain sufficient snapshot quota for epoch-based automatic snapshot policy.
7494
+ * - The disk must be in the Pending Attach (Available) state when you release it.
7489
7495
  * - If the disk with the specified ID does not exist, the request is ignored.
7490
7496
  *
7491
7497
  * @param request - DeleteDiskRequest
@@ -8882,13 +8888,13 @@ class Client extends openapi_core_1.default {
8882
8888
  return await this.deleteSecurityGroupWithOptions(request, runtime);
8883
8889
  }
8884
8890
  /**
8885
- * Deletes a specified snapshot. If you call this operation to delete a snapshot that is being created, the associated snapshot creation task is also canceled.
8891
+ * Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
8886
8892
  *
8887
8893
  * @remarks
8888
- * Take note of the following items:
8889
- * - If the snapshot does not exist, the request is ignored.
8890
- * - If the snapshot has been used to create custom images, the snapshot cannot be deleted. You need to call the [DeleteImage](https://help.aliyun.com/document_detail/25537.html) operation to delete the custom images before you can delete the snapshot.
8891
- * - If the snapshot has been used to create disks and `Force` is not specified or is set to `false`, the snapshot cannot be deleted directly. If you want to delete the snapshot, set `Force` to true to forcibly delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is forcibly deleted.
8894
+ * When you invoke this operation, note the following items:
8895
+ * - If the specified snapshot ID does not exist, the request is ignored.
8896
+ * - If the snapshot has been used to create a custom image, the snapshot cannot be deleted. You must first delete the custom image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)) before you can delete the snapshot.
8897
+ * - If the snapshot has been used to create a cloud disk and the `Force` parameter is not set or is set to `Force=false`, the snapshot cannot be directly deleted. To delete the snapshot, set `Force=true` to force delete it. After the snapshot is force deleted, the corresponding cloud disk cannot be reinitialized.
8892
8898
  *
8893
8899
  * @param request - DeleteSnapshotRequest
8894
8900
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8932,13 +8938,13 @@ class Client extends openapi_core_1.default {
8932
8938
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteSnapshotResponse({}));
8933
8939
  }
8934
8940
  /**
8935
- * Deletes a specified snapshot. If you call this operation to delete a snapshot that is being created, the associated snapshot creation task is also canceled.
8941
+ * Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
8936
8942
  *
8937
8943
  * @remarks
8938
- * Take note of the following items:
8939
- * - If the snapshot does not exist, the request is ignored.
8940
- * - If the snapshot has been used to create custom images, the snapshot cannot be deleted. You need to call the [DeleteImage](https://help.aliyun.com/document_detail/25537.html) operation to delete the custom images before you can delete the snapshot.
8941
- * - If the snapshot has been used to create disks and `Force` is not specified or is set to `false`, the snapshot cannot be deleted directly. If you want to delete the snapshot, set `Force` to true to forcibly delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is forcibly deleted.
8944
+ * When you invoke this operation, note the following items:
8945
+ * - If the specified snapshot ID does not exist, the request is ignored.
8946
+ * - If the snapshot has been used to create a custom image, the snapshot cannot be deleted. You must first delete the custom image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)) before you can delete the snapshot.
8947
+ * - If the snapshot has been used to create a cloud disk and the `Force` parameter is not set or is set to `Force=false`, the snapshot cannot be directly deleted. To delete the snapshot, set `Force=true` to force delete it. After the snapshot is force deleted, the corresponding cloud disk cannot be reinitialized.
8942
8948
  *
8943
8949
  * @param request - DeleteSnapshotRequest
8944
8950
  * @returns DeleteSnapshotResponse
@@ -8948,10 +8954,10 @@ class Client extends openapi_core_1.default {
8948
8954
  return await this.deleteSnapshotWithOptions(request, runtime);
8949
8955
  }
8950
8956
  /**
8951
- * Deletes snapshot-consistent groups.
8957
+ * Deletes a snapshot-consistent group.
8952
8958
  *
8953
8959
  * @remarks
8954
- * If a disk snapshot that is contained in a snapshot-consistent group has been used to create a custom image, the disk snapshot is retained after the snapshot-consistent group is deleted. Before you can delete the disk snapshot, you must call the [DeleteImage](https://help.aliyun.com/document_detail/25537.html) operation to delete the custom image. Then, you can call the [DeleteSnapshot](https://help.aliyun.com/document_detail/25525.html) operation to delete the disk snapshot.
8960
+ * If disk snapshots in a snapshot-consistent group have been used to create custom images, the related disk snapshots are not deleted when the snapshot-consistent group is deleted. To delete the related disk snapshots, first delete the custom images ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)), and then delete the related disk snapshots ([DeleteSnapshot](https://help.aliyun.com/document_detail/25525.html)).
8955
8961
  *
8956
8962
  * @param request - DeleteSnapshotGroupRequest
8957
8963
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8995,10 +9001,10 @@ class Client extends openapi_core_1.default {
8995
9001
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteSnapshotGroupResponse({}));
8996
9002
  }
8997
9003
  /**
8998
- * Deletes snapshot-consistent groups.
9004
+ * Deletes a snapshot-consistent group.
8999
9005
  *
9000
9006
  * @remarks
9001
- * If a disk snapshot that is contained in a snapshot-consistent group has been used to create a custom image, the disk snapshot is retained after the snapshot-consistent group is deleted. Before you can delete the disk snapshot, you must call the [DeleteImage](https://help.aliyun.com/document_detail/25537.html) operation to delete the custom image. Then, you can call the [DeleteSnapshot](https://help.aliyun.com/document_detail/25525.html) operation to delete the disk snapshot.
9007
+ * If disk snapshots in a snapshot-consistent group have been used to create custom images, the related disk snapshots are not deleted when the snapshot-consistent group is deleted. To delete the related disk snapshots, first delete the custom images ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)), and then delete the related disk snapshots ([DeleteSnapshot](https://help.aliyun.com/document_detail/25525.html)).
9002
9008
  *
9003
9009
  * @param request - DeleteSnapshotGroupRequest
9004
9010
  * @returns DeleteSnapshotGroupResponse
@@ -11408,7 +11414,7 @@ class Client extends openapi_core_1.default {
11408
11414
  return await this.describeDiagnosticReportsWithOptions(request, runtime);
11409
11415
  }
11410
11416
  /**
11411
- * Queries the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
11417
+ * Queries the key used for account-level default encryption of block storage.
11412
11418
  *
11413
11419
  * @param request - DescribeDiskDefaultKMSKeyIdRequest
11414
11420
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11443,7 +11449,7 @@ class Client extends openapi_core_1.default {
11443
11449
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeDiskDefaultKMSKeyIdResponse({}));
11444
11450
  }
11445
11451
  /**
11446
- * Queries the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
11452
+ * Queries the key used for account-level default encryption of block storage.
11447
11453
  *
11448
11454
  * @param request - DescribeDiskDefaultKMSKeyIdRequest
11449
11455
  * @returns DescribeDiskDefaultKMSKeyIdResponse
@@ -11453,7 +11459,7 @@ class Client extends openapi_core_1.default {
11453
11459
  return await this.describeDiskDefaultKMSKeyIdWithOptions(request, runtime);
11454
11460
  }
11455
11461
  /**
11456
- * Queries whether account-level default encryption of Elastic Block Storage (EBS) resources is enabled in a region.
11462
+ * Queries the service status of account-level default encryption for block storage in a specified region.
11457
11463
  *
11458
11464
  * @param request - DescribeDiskEncryptionByDefaultStatusRequest
11459
11465
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11488,7 +11494,7 @@ class Client extends openapi_core_1.default {
11488
11494
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeDiskEncryptionByDefaultStatusResponse({}));
11489
11495
  }
11490
11496
  /**
11491
- * Queries whether account-level default encryption of Elastic Block Storage (EBS) resources is enabled in a region.
11497
+ * Queries the service status of account-level default encryption for block storage in a specified region.
11492
11498
  *
11493
11499
  * @param request - DescribeDiskEncryptionByDefaultStatusRequest
11494
11500
  * @returns DescribeDiskEncryptionByDefaultStatusResponse
@@ -12909,7 +12915,7 @@ class Client extends openapi_core_1.default {
12909
12915
  return await this.describeImageSupportInstanceTypesWithOptions(request, runtime);
12910
12916
  }
12911
12917
  /**
12912
- * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
12918
+ * Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
12913
12919
  *
12914
12920
  * @remarks
12915
12921
  * - 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.
@@ -13002,6 +13008,9 @@ class Client extends openapi_core_1.default {
13002
13008
  if (!$dara.isNull(request.tag)) {
13003
13009
  query["Tag"] = request.tag;
13004
13010
  }
13011
+ if (!$dara.isNull(request.usable)) {
13012
+ query["Usable"] = request.usable;
13013
+ }
13005
13014
  if (!$dara.isNull(request.usage)) {
13006
13015
  query["Usage"] = request.usage;
13007
13016
  }
@@ -13022,7 +13031,7 @@ class Client extends openapi_core_1.default {
13022
13031
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeImagesResponse({}));
13023
13032
  }
13024
13033
  /**
13025
- * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
13034
+ * Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
13026
13035
  *
13027
13036
  * @remarks
13028
13037
  * - 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.
@@ -17333,13 +17342,13 @@ class Client extends openapi_core_1.default {
17333
17342
  return await this.describeSecurityGroupsWithOptions(request, runtime);
17334
17343
  }
17335
17344
  /**
17336
- * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
17345
+ * Queries the list and status of files sent by Cloud Assistant.
17337
17346
  *
17338
17347
  * @remarks
17339
17348
  * ## Operation description:
17340
- * - After you send a file, the file is not necessarily sent. You must check the actual sending result based on the return value of this operation.
17341
- * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
17342
- * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value returned in the result serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the value obtained from the previous response and set MaxResults to limit the number of entries to return.
17349
+ * - After you send a file, the file is not necessarily sent successfully. You must check the actual delivery result based on the return value of this operation. The actual output prevails.
17350
+ * - You can query execution information from the last day. A maximum of 1,000 entries of execution information can be retained.
17351
+ * - When you execute a paging query for the first page, set only `MaxResults` to limit the number of entries returned. The `NextToken` value in the response serves as the token for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the value obtained from the previous response and set `MaxResults` to limit the number of entries returned.
17343
17352
  *
17344
17353
  * @param request - DescribeSendFileResultsRequest
17345
17354
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17413,13 +17422,13 @@ class Client extends openapi_core_1.default {
17413
17422
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSendFileResultsResponse({}));
17414
17423
  }
17415
17424
  /**
17416
- * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
17425
+ * Queries the list and status of files sent by Cloud Assistant.
17417
17426
  *
17418
17427
  * @remarks
17419
17428
  * ## Operation description:
17420
- * - After you send a file, the file is not necessarily sent. You must check the actual sending result based on the return value of this operation.
17421
- * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
17422
- * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value returned in the result serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the value obtained from the previous response and set MaxResults to limit the number of entries to return.
17429
+ * - After you send a file, the file is not necessarily sent successfully. You must check the actual delivery result based on the return value of this operation. The actual output prevails.
17430
+ * - You can query execution information from the last day. A maximum of 1,000 entries of execution information can be retained.
17431
+ * - When you execute a paging query for the first page, set only `MaxResults` to limit the number of entries returned. The `NextToken` value in the response serves as the token for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the value obtained from the previous response and set `MaxResults` to limit the number of entries returned.
17423
17432
  *
17424
17433
  * @param request - DescribeSendFileResultsRequest
17425
17434
  * @returns DescribeSendFileResultsResponse
@@ -17429,10 +17438,10 @@ class Client extends openapi_core_1.default {
17429
17438
  return await this.describeSendFileResultsWithOptions(request, runtime);
17430
17439
  }
17431
17440
  /**
17432
- * Queries the information of one or more snapshot-consistent groups, such as the status of the groups, IDs of the instances associated with the groups, and snapshot creation progress.
17441
+ * Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
17433
17442
  *
17434
17443
  * @remarks
17435
- * You can specify multiple request parameters to be queried, such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N`. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
17444
+ * `InstanceId`, `SnapshotGroupId.N`, and `Status.N` are not required request parameters, but they can be used to build filter logic. The parameters have a logical AND relationship.
17436
17445
  *
17437
17446
  * @param request - DescribeSnapshotGroupsRequest
17438
17447
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17500,10 +17509,10 @@ class Client extends openapi_core_1.default {
17500
17509
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSnapshotGroupsResponse({}));
17501
17510
  }
17502
17511
  /**
17503
- * Queries the information of one or more snapshot-consistent groups, such as the status of the groups, IDs of the instances associated with the groups, and snapshot creation progress.
17512
+ * Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
17504
17513
  *
17505
17514
  * @remarks
17506
- * You can specify multiple request parameters to be queried, such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N`. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
17515
+ * `InstanceId`, `SnapshotGroupId.N`, and `Status.N` are not required request parameters, but they can be used to build filter logic. The parameters have a logical AND relationship.
17507
17516
  *
17508
17517
  * @param request - DescribeSnapshotGroupsRequest
17509
17518
  * @returns DescribeSnapshotGroupsResponse
@@ -19632,14 +19641,14 @@ class Client extends openapi_core_1.default {
19632
19641
  return await this.disableActivationWithOptions(request, runtime);
19633
19642
  }
19634
19643
  /**
19635
- * Disables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you disable account-level default encryption of EBS resources in a region, the encryption status of existing disks in the region does not change. When you create a disk, you can still choose to encrypt the disk.
19644
+ * Disables the account-level default encryption for block storage in a specified region.
19636
19645
  *
19637
19646
  * @remarks
19638
- * - **Instructions**
19639
- * - You must grant the RAM user the `AliyunECSFullAccess` permissions. For information about how to grant permissions to a RAM user, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/116146.html).
19640
- * - **Considerations**
19641
- * - After Account-level EBS Default Encryption is disabled, the encryption status of existing cloud disks is not affected.
19642
- * - After Account-level EBS Default Encryption is disabled, you can still choose to encrypt new cloud disks when you purchase the disks.
19647
+ * - **Before you begin**
19648
+ * - Resource Access Management (RAM) users require the `AliyunECSFullAccess` permission. For more information about how to perform authorization, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/116146.html).
19649
+ * - **Usage notes**
19650
+ * - After you shutdown account-level default encryption for block storage, the encryption status of existing cloud disks is not affected.
19651
+ * - After you shutdown account-level default encryption for block storage, you can still manually select encryption when you create cloud disks.
19643
19652
  *
19644
19653
  * @param request - DisableDiskEncryptionByDefaultRequest
19645
19654
  * @param runtime - runtime options for this request RuntimeOptions
@@ -19674,14 +19683,14 @@ class Client extends openapi_core_1.default {
19674
19683
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DisableDiskEncryptionByDefaultResponse({}));
19675
19684
  }
19676
19685
  /**
19677
- * Disables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you disable account-level default encryption of EBS resources in a region, the encryption status of existing disks in the region does not change. When you create a disk, you can still choose to encrypt the disk.
19686
+ * Disables the account-level default encryption for block storage in a specified region.
19678
19687
  *
19679
19688
  * @remarks
19680
- * - **Instructions**
19681
- * - You must grant the RAM user the `AliyunECSFullAccess` permissions. For information about how to grant permissions to a RAM user, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/116146.html).
19682
- * - **Considerations**
19683
- * - After Account-level EBS Default Encryption is disabled, the encryption status of existing cloud disks is not affected.
19684
- * - After Account-level EBS Default Encryption is disabled, you can still choose to encrypt new cloud disks when you purchase the disks.
19689
+ * - **Before you begin**
19690
+ * - Resource Access Management (RAM) users require the `AliyunECSFullAccess` permission. For more information about how to perform authorization, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/116146.html).
19691
+ * - **Usage notes**
19692
+ * - After you shutdown account-level default encryption for block storage, the encryption status of existing cloud disks is not affected.
19693
+ * - After you shutdown account-level default encryption for block storage, you can still manually select encryption when you create cloud disks.
19685
19694
  *
19686
19695
  * @param request - DisableDiskEncryptionByDefaultRequest
19687
19696
  * @returns DisableDiskEncryptionByDefaultResponse