@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.
- package/dist/client.d.ts +226 -220
- package/dist/client.js +229 -220
- package/dist/client.js.map +1 -1
- package/dist/models/AttachDiskRequest.d.ts +25 -27
- package/dist/models/AttachDiskRequest.js.map +1 -1
- package/dist/models/CancelAutoSnapshotPolicyRequest.d.ts +6 -9
- package/dist/models/CancelAutoSnapshotPolicyRequest.js.map +1 -1
- package/dist/models/CancelImagePipelineExecutionRequest.d.ts +1 -1
- package/dist/models/CloneDisksRequest.d.ts +10 -10
- package/dist/models/CopySnapshotRequest.d.ts +17 -18
- package/dist/models/CopySnapshotRequest.js.map +1 -1
- package/dist/models/CreateAutoSnapshotPolicyRequest.d.ts +29 -35
- package/dist/models/CreateAutoSnapshotPolicyRequest.js.map +1 -1
- package/dist/models/CreateAutoSnapshotPolicyResponseBody.d.ts +1 -1
- package/dist/models/CreateDiskRequest.d.ts +30 -30
- package/dist/models/CreateDiskResponseBody.d.ts +2 -2
- package/dist/models/CreateSnapshotGroupRequest.d.ts +23 -25
- package/dist/models/CreateSnapshotGroupRequest.js.map +1 -1
- package/dist/models/CreateSnapshotRequest.d.ts +24 -29
- package/dist/models/CreateSnapshotRequest.js.map +1 -1
- package/dist/models/DeleteSnapshotGroupRequest.d.ts +2 -2
- package/dist/models/DeleteSnapshotGroupResponseBody.d.ts +1 -1
- package/dist/models/DeleteSnapshotRequest.d.ts +2 -2
- package/dist/models/DescribeDiskDefaultKmskeyIdRequest.d.ts +1 -1
- package/dist/models/DescribeDiskDefaultKmskeyIdResponseBody.d.ts +1 -1
- package/dist/models/DescribeDiskEncryptionByDefaultStatusRequest.d.ts +1 -1
- package/dist/models/DescribeDiskEncryptionByDefaultStatusResponseBody.d.ts +5 -3
- package/dist/models/DescribeDiskEncryptionByDefaultStatusResponseBody.js.map +1 -1
- package/dist/models/DescribeImagesRequest.d.ts +21 -20
- package/dist/models/DescribeImagesRequest.js +2 -0
- package/dist/models/DescribeImagesRequest.js.map +1 -1
- package/dist/models/DescribeImagesResponseBody.d.ts +1 -0
- package/dist/models/DescribeImagesResponseBody.js +2 -0
- package/dist/models/DescribeImagesResponseBody.js.map +1 -1
- package/dist/models/DescribeSendFileResultsRequest.d.ts +13 -13
- package/dist/models/DescribeSnapshotGroupsRequest.d.ts +11 -11
- package/dist/models/DescribeSnapshotGroupsResponseBody.d.ts +3 -3
- package/dist/models/DisableDiskEncryptionByDefaultRequest.d.ts +1 -1
- package/package.json +1 -1
- package/src/client.ts +230 -220
- package/src/models/AttachDiskRequest.ts +25 -27
- package/src/models/CancelAutoSnapshotPolicyRequest.ts +6 -9
- package/src/models/CancelImagePipelineExecutionRequest.ts +1 -1
- package/src/models/CloneDisksRequest.ts +10 -10
- package/src/models/CopySnapshotRequest.ts +17 -18
- package/src/models/CreateAutoSnapshotPolicyRequest.ts +29 -35
- package/src/models/CreateAutoSnapshotPolicyResponseBody.ts +1 -1
- package/src/models/CreateDiskRequest.ts +30 -30
- package/src/models/CreateDiskResponseBody.ts +2 -2
- package/src/models/CreateSnapshotGroupRequest.ts +23 -25
- package/src/models/CreateSnapshotRequest.ts +24 -29
- package/src/models/DeleteSnapshotGroupRequest.ts +2 -2
- package/src/models/DeleteSnapshotGroupResponseBody.ts +1 -1
- package/src/models/DeleteSnapshotRequest.ts +2 -2
- package/src/models/DescribeDiskDefaultKmskeyIdRequest.ts +1 -1
- package/src/models/DescribeDiskDefaultKmskeyIdResponseBody.ts +1 -1
- package/src/models/DescribeDiskEncryptionByDefaultStatusRequest.ts +1 -1
- package/src/models/DescribeDiskEncryptionByDefaultStatusResponseBody.ts +5 -3
- package/src/models/DescribeImagesRequest.ts +23 -20
- package/src/models/DescribeImagesResponseBody.ts +3 -0
- package/src/models/DescribeSendFileResultsRequest.ts +13 -13
- package/src/models/DescribeSnapshotGroupsRequest.ts +11 -11
- package/src/models/DescribeSnapshotGroupsResponseBody.ts +3 -3
- package/src/models/DisableDiskEncryptionByDefaultRequest.ts +1 -1
package/src/client.ts
CHANGED
|
@@ -1231,24 +1231,27 @@ export default class Client extends OpenApi {
|
|
|
1231
1231
|
}
|
|
1232
1232
|
|
|
1233
1233
|
/**
|
|
1234
|
-
* Attaches a
|
|
1234
|
+
* Attaches a data disk or system disk to an ECS instance.
|
|
1235
1235
|
*
|
|
1236
1236
|
* @remarks
|
|
1237
|
-
*
|
|
1238
|
-
* - The
|
|
1239
|
-
* - The disk must be in the **
|
|
1240
|
-
* - When you attach
|
|
1241
|
-
*
|
|
1242
|
-
*
|
|
1243
|
-
*
|
|
1244
|
-
*
|
|
1245
|
-
* - When you attach
|
|
1246
|
-
*
|
|
1247
|
-
*
|
|
1248
|
-
*
|
|
1249
|
-
*
|
|
1250
|
-
*
|
|
1251
|
-
* -
|
|
1237
|
+
* When you call this operation, take note of the following items:
|
|
1238
|
+
* - The instance and the disk must be in the same zone.
|
|
1239
|
+
* - The disk must be in the **Available** (`Available`) state.
|
|
1240
|
+
* - When you attach a data disk:
|
|
1241
|
+
* - The destination ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
|
|
1242
|
+
* - If the disk is separately purchased, the billing method must be pay-as-you-go.
|
|
1243
|
+
* - A system disk that was uninstalled from an ECS instance can be attached as a data disk without billable methods restrictions.
|
|
1244
|
+
* - An elastic ephemeral disk that has been detached can only be re-attached to its original instance.
|
|
1245
|
+
* - When you attach a system disk:
|
|
1246
|
+
* - The destination ECS instance must be the original instance from which the system disk was detached.
|
|
1247
|
+
* - The destination ECS instance must be in the **Stopped** (`Stopped`) state.
|
|
1248
|
+
* - You must specify the logon credential for the instance.
|
|
1249
|
+
* - Elastic ephemeral disks cannot be attached as system disks.
|
|
1250
|
+
* - For more information about attaching system disks, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
|
|
1251
|
+
* - When you query ECS instance information, if the response contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
|
|
1252
|
+
* <props="china">
|
|
1253
|
+
* - A disk with the multi-attach attribute enabled can only be attached to instances that support the NVMe protocol.
|
|
1254
|
+
* 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).
|
|
1252
1255
|
*
|
|
1253
1256
|
* @param request - AttachDiskRequest
|
|
1254
1257
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -1323,24 +1326,27 @@ export default class Client extends OpenApi {
|
|
|
1323
1326
|
}
|
|
1324
1327
|
|
|
1325
1328
|
/**
|
|
1326
|
-
* Attaches a
|
|
1329
|
+
* Attaches a data disk or system disk to an ECS instance.
|
|
1327
1330
|
*
|
|
1328
1331
|
* @remarks
|
|
1329
|
-
*
|
|
1330
|
-
* - The
|
|
1331
|
-
* - The disk must be in the **
|
|
1332
|
-
* - When you attach
|
|
1333
|
-
*
|
|
1334
|
-
*
|
|
1335
|
-
*
|
|
1336
|
-
*
|
|
1337
|
-
* - When you attach
|
|
1338
|
-
*
|
|
1339
|
-
*
|
|
1340
|
-
*
|
|
1341
|
-
*
|
|
1342
|
-
*
|
|
1343
|
-
* -
|
|
1332
|
+
* When you call this operation, take note of the following items:
|
|
1333
|
+
* - The instance and the disk must be in the same zone.
|
|
1334
|
+
* - The disk must be in the **Available** (`Available`) state.
|
|
1335
|
+
* - When you attach a data disk:
|
|
1336
|
+
* - The destination ECS instance must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
|
|
1337
|
+
* - If the disk is separately purchased, the billing method must be pay-as-you-go.
|
|
1338
|
+
* - A system disk that was uninstalled from an ECS instance can be attached as a data disk without billable methods restrictions.
|
|
1339
|
+
* - An elastic ephemeral disk that has been detached can only be re-attached to its original instance.
|
|
1340
|
+
* - When you attach a system disk:
|
|
1341
|
+
* - The destination ECS instance must be the original instance from which the system disk was detached.
|
|
1342
|
+
* - The destination ECS instance must be in the **Stopped** (`Stopped`) state.
|
|
1343
|
+
* - You must specify the logon credential for the instance.
|
|
1344
|
+
* - Elastic ephemeral disks cannot be attached as system disks.
|
|
1345
|
+
* - For more information about attaching system disks, see [Detach or attach a system disk](https://help.aliyun.com/document_detail/146752.html).
|
|
1346
|
+
* - When you query ECS instance information, if the response contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
|
|
1347
|
+
* <props="china">
|
|
1348
|
+
* - A disk with the multi-attach attribute enabled can only be attached to instances that support the NVMe protocol.
|
|
1349
|
+
* 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).
|
|
1344
1350
|
*
|
|
1345
1351
|
* @param request - AttachDiskRequest
|
|
1346
1352
|
* @returns AttachDiskResponse
|
|
@@ -2095,7 +2101,7 @@ export default class Client extends OpenApi {
|
|
|
2095
2101
|
}
|
|
2096
2102
|
|
|
2097
2103
|
/**
|
|
2098
|
-
* Cancels
|
|
2104
|
+
* Cancels the automatic snapshot policy for one or more cloud disks.
|
|
2099
2105
|
*
|
|
2100
2106
|
* @param request - CancelAutoSnapshotPolicyRequest
|
|
2101
2107
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2146,7 +2152,7 @@ export default class Client extends OpenApi {
|
|
|
2146
2152
|
}
|
|
2147
2153
|
|
|
2148
2154
|
/**
|
|
2149
|
-
* Cancels
|
|
2155
|
+
* Cancels the automatic snapshot policy for one or more cloud disks.
|
|
2150
2156
|
*
|
|
2151
2157
|
* @param request - CancelAutoSnapshotPolicyRequest
|
|
2152
2158
|
* @returns CancelAutoSnapshotPolicyResponse
|
|
@@ -2229,10 +2235,10 @@ export default class Client extends OpenApi {
|
|
|
2229
2235
|
}
|
|
2230
2236
|
|
|
2231
2237
|
/**
|
|
2232
|
-
* Cancels an image
|
|
2238
|
+
* Cancels an image building task.
|
|
2233
2239
|
*
|
|
2234
2240
|
* @remarks
|
|
2235
|
-
* Before you call this operation, make sure that the image
|
|
2241
|
+
* Before you call this operation, make sure that the image building task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
|
|
2236
2242
|
*
|
|
2237
2243
|
* @param request - CancelImagePipelineExecutionRequest
|
|
2238
2244
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2291,10 +2297,10 @@ export default class Client extends OpenApi {
|
|
|
2291
2297
|
}
|
|
2292
2298
|
|
|
2293
2299
|
/**
|
|
2294
|
-
* Cancels an image
|
|
2300
|
+
* Cancels an image building task.
|
|
2295
2301
|
*
|
|
2296
2302
|
* @remarks
|
|
2297
|
-
* Before you call this operation, make sure that the image
|
|
2303
|
+
* Before you call this operation, make sure that the image building task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
|
|
2298
2304
|
*
|
|
2299
2305
|
* @param request - CancelImagePipelineExecutionRequest
|
|
2300
2306
|
* @returns CancelImagePipelineExecutionResponse
|
|
@@ -2504,28 +2510,28 @@ export default class Client extends OpenApi {
|
|
|
2504
2510
|
}
|
|
2505
2511
|
|
|
2506
2512
|
/**
|
|
2507
|
-
* Disk cloning allows you to quickly
|
|
2513
|
+
* 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.
|
|
2508
2514
|
*
|
|
2509
2515
|
* @remarks
|
|
2510
|
-
* > The disk cloning feature itself is free of charge,
|
|
2511
|
-
* ###
|
|
2512
|
-
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to
|
|
2516
|
+
* > 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.
|
|
2517
|
+
* ### Usage notes
|
|
2518
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to query the execution result.
|
|
2513
2519
|
* ### Features
|
|
2514
|
-
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk`
|
|
2515
|
-
* - Non-regional disks can
|
|
2520
|
+
* - 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.
|
|
2521
|
+
* - Non-regional disks can be cloned only to non-regional types. Regional disks can be cloned only to regional disk types.
|
|
2516
2522
|
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
2517
|
-
* - You can specify the `new disk` type and performance level
|
|
2518
|
-
* - You can specify the `new disk` capacity during cloning
|
|
2519
|
-
* - You can configure provisioned performance and performance burst for the `new disk
|
|
2520
|
-
* - You can specify encryption for the `new disk`
|
|
2521
|
-
* - You can use a subscription disk as the `source disk
|
|
2522
|
-
* - The `new disk`
|
|
2523
|
-
* - Cloning does not support storage sets or dedicated block storage clusters,
|
|
2523
|
+
* - You can specify the `new disk` type and performance level during cloning.
|
|
2524
|
+
* - You can specify the `new disk` capacity during cloning. The new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
2525
|
+
* - 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.
|
|
2526
|
+
* - 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.
|
|
2527
|
+
* - You can use a subscription disk as the `source disk` for cloning, even if the subscription disk has expired.
|
|
2528
|
+
* - The cloned `new disk` does not support reinitialization.
|
|
2529
|
+
* - 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.
|
|
2524
2530
|
* - `Source disk` status restrictions:
|
|
2525
2531
|
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2526
2532
|
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2527
|
-
* -
|
|
2528
|
-
* -
|
|
2533
|
+
* - Disks undergoing specification changes cannot be used as the `source disk`.
|
|
2534
|
+
* - Disks undergoing expansion cannot be used as the `source disk`.
|
|
2529
2535
|
* - 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`.
|
|
2530
2536
|
*
|
|
2531
2537
|
* @param request - CloneDisksRequest
|
|
@@ -2625,28 +2631,28 @@ export default class Client extends OpenApi {
|
|
|
2625
2631
|
}
|
|
2626
2632
|
|
|
2627
2633
|
/**
|
|
2628
|
-
* Disk cloning allows you to quickly
|
|
2634
|
+
* 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.
|
|
2629
2635
|
*
|
|
2630
2636
|
* @remarks
|
|
2631
|
-
* > The disk cloning feature itself is free of charge,
|
|
2632
|
-
* ###
|
|
2633
|
-
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to
|
|
2637
|
+
* > 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.
|
|
2638
|
+
* ### Usage notes
|
|
2639
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to query the execution result.
|
|
2634
2640
|
* ### Features
|
|
2635
|
-
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk`
|
|
2636
|
-
* - Non-regional disks can
|
|
2641
|
+
* - 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.
|
|
2642
|
+
* - Non-regional disks can be cloned only to non-regional types. Regional disks can be cloned only to regional disk types.
|
|
2637
2643
|
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
2638
|
-
* - You can specify the `new disk` type and performance level
|
|
2639
|
-
* - You can specify the `new disk` capacity during cloning
|
|
2640
|
-
* - You can configure provisioned performance and performance burst for the `new disk
|
|
2641
|
-
* - You can specify encryption for the `new disk`
|
|
2642
|
-
* - You can use a subscription disk as the `source disk
|
|
2643
|
-
* - The `new disk`
|
|
2644
|
-
* - Cloning does not support storage sets or dedicated block storage clusters,
|
|
2644
|
+
* - You can specify the `new disk` type and performance level during cloning.
|
|
2645
|
+
* - You can specify the `new disk` capacity during cloning. The new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
2646
|
+
* - 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.
|
|
2647
|
+
* - 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.
|
|
2648
|
+
* - You can use a subscription disk as the `source disk` for cloning, even if the subscription disk has expired.
|
|
2649
|
+
* - The cloned `new disk` does not support reinitialization.
|
|
2650
|
+
* - 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.
|
|
2645
2651
|
* - `Source disk` status restrictions:
|
|
2646
2652
|
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2647
2653
|
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2648
|
-
* -
|
|
2649
|
-
* -
|
|
2654
|
+
* - Disks undergoing specification changes cannot be used as the `source disk`.
|
|
2655
|
+
* - Disks undergoing expansion cannot be used as the `source disk`.
|
|
2650
2656
|
* - 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`.
|
|
2651
2657
|
*
|
|
2652
2658
|
* @param request - CloneDisksRequest
|
|
@@ -2923,11 +2929,11 @@ export default class Client extends OpenApi {
|
|
|
2923
2929
|
}
|
|
2924
2930
|
|
|
2925
2931
|
/**
|
|
2926
|
-
* Copies a standard or encrypted snapshot from one region to another.
|
|
2932
|
+
* Copies a standard snapshot or encrypted snapshot from one region to another.
|
|
2927
2933
|
*
|
|
2928
2934
|
* @remarks
|
|
2929
|
-
* When you call this operation, take note of the following
|
|
2930
|
-
* -
|
|
2935
|
+
* When you call this operation, take note of the following items:
|
|
2936
|
+
* - The new snapshot cannot be used to roll back the cloud disk that is associated with the source snapshot.
|
|
2931
2937
|
* - Local snapshots cannot be copied.
|
|
2932
2938
|
*
|
|
2933
2939
|
* @param request - CopySnapshotRequest
|
|
@@ -3019,11 +3025,11 @@ export default class Client extends OpenApi {
|
|
|
3019
3025
|
}
|
|
3020
3026
|
|
|
3021
3027
|
/**
|
|
3022
|
-
* Copies a standard or encrypted snapshot from one region to another.
|
|
3028
|
+
* Copies a standard snapshot or encrypted snapshot from one region to another.
|
|
3023
3029
|
*
|
|
3024
3030
|
* @remarks
|
|
3025
|
-
* When you call this operation, take note of the following
|
|
3026
|
-
* -
|
|
3031
|
+
* When you call this operation, take note of the following items:
|
|
3032
|
+
* - The new snapshot cannot be used to roll back the cloud disk that is associated with the source snapshot.
|
|
3027
3033
|
* - Local snapshots cannot be copied.
|
|
3028
3034
|
*
|
|
3029
3035
|
* @param request - CopySnapshotRequest
|
|
@@ -3365,15 +3371,15 @@ export default class Client extends OpenApi {
|
|
|
3365
3371
|
}
|
|
3366
3372
|
|
|
3367
3373
|
/**
|
|
3368
|
-
* Creates an automatic snapshot policy in a
|
|
3374
|
+
* 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.
|
|
3369
3375
|
*
|
|
3370
3376
|
* @remarks
|
|
3371
|
-
* Before you call this operation,
|
|
3377
|
+
* Before you call this operation, read [Create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
|
|
3372
3378
|
* Take note of the following items:
|
|
3373
|
-
* - You can create
|
|
3374
|
-
* -
|
|
3375
|
-
* - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are
|
|
3376
|
-
* After
|
|
3379
|
+
* - 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.
|
|
3380
|
+
* - The system does not execute automatic snapshot policies when an ECS instance has a pending stop or restart task.
|
|
3381
|
+
* - 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).
|
|
3382
|
+
* 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).
|
|
3377
3383
|
*
|
|
3378
3384
|
* @param request - CreateAutoSnapshotPolicyRequest
|
|
3379
3385
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -3460,15 +3466,15 @@ export default class Client extends OpenApi {
|
|
|
3460
3466
|
}
|
|
3461
3467
|
|
|
3462
3468
|
/**
|
|
3463
|
-
* Creates an automatic snapshot policy in a
|
|
3469
|
+
* 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.
|
|
3464
3470
|
*
|
|
3465
3471
|
* @remarks
|
|
3466
|
-
* Before you call this operation,
|
|
3472
|
+
* Before you call this operation, read [Create an automatic snapshot policy](https://help.aliyun.com/document_detail/127767.html).
|
|
3467
3473
|
* Take note of the following items:
|
|
3468
|
-
* - You can create
|
|
3469
|
-
* -
|
|
3470
|
-
* - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are
|
|
3471
|
-
* After
|
|
3474
|
+
* - 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.
|
|
3475
|
+
* - The system does not execute automatic snapshot policies when an ECS instance has a pending stop or restart task.
|
|
3476
|
+
* - 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).
|
|
3477
|
+
* 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).
|
|
3472
3478
|
*
|
|
3473
3479
|
* @param request - CreateAutoSnapshotPolicyRequest
|
|
3474
3480
|
* @returns CreateAutoSnapshotPolicyResponse
|
|
@@ -4058,14 +4064,14 @@ export default class Client extends OpenApi {
|
|
|
4058
4064
|
* Creates a pay-as-you-go or subscription data disk.
|
|
4059
4065
|
*
|
|
4060
4066
|
* @remarks
|
|
4061
|
-
* -
|
|
4067
|
+
* - 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).
|
|
4062
4068
|
* - 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.
|
|
4063
|
-
* -
|
|
4064
|
-
* - Creating a disk incurs
|
|
4069
|
+
* - 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.
|
|
4070
|
+
* - 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).
|
|
4065
4071
|
* - Default settings when you create a disk:
|
|
4066
|
-
* - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can
|
|
4067
|
-
* - When you create an enterprise SSD, if you do not configure
|
|
4068
|
-
* - The billing method is pay-as-you-go
|
|
4072
|
+
* - 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.
|
|
4073
|
+
* - 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.
|
|
4074
|
+
* - The billing method is pay-as-you-go. That is, the `Portable` property defaults to `true`.
|
|
4069
4075
|
*
|
|
4070
4076
|
* @param request - CreateDiskRequest
|
|
4071
4077
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4203,14 +4209,14 @@ export default class Client extends OpenApi {
|
|
|
4203
4209
|
* Creates a pay-as-you-go or subscription data disk.
|
|
4204
4210
|
*
|
|
4205
4211
|
* @remarks
|
|
4206
|
-
* -
|
|
4212
|
+
* - 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).
|
|
4207
4213
|
* - 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.
|
|
4208
|
-
* -
|
|
4209
|
-
* - Creating a disk incurs
|
|
4214
|
+
* - 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.
|
|
4215
|
+
* - 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).
|
|
4210
4216
|
* - Default settings when you create a disk:
|
|
4211
|
-
* - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can
|
|
4212
|
-
* - When you create an enterprise SSD, if you do not configure
|
|
4213
|
-
* - The billing method is pay-as-you-go
|
|
4217
|
+
* - 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.
|
|
4218
|
+
* - 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.
|
|
4219
|
+
* - The billing method is pay-as-you-go. That is, the `Portable` property defaults to `true`.
|
|
4214
4220
|
*
|
|
4215
4221
|
* @param request - CreateDiskRequest
|
|
4216
4222
|
* @returns CreateDiskResponse
|
|
@@ -7307,30 +7313,30 @@ export default class Client extends OpenApi {
|
|
|
7307
7313
|
}
|
|
7308
7314
|
|
|
7309
7315
|
/**
|
|
7310
|
-
*
|
|
7311
|
-
*
|
|
7312
|
-
* @remarks
|
|
7313
|
-
* The
|
|
7314
|
-
* - If you used local snapshots before December 14, 2020, you can
|
|
7315
|
-
* - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots
|
|
7316
|
-
*
|
|
7317
|
-
* -
|
|
7318
|
-
* - The
|
|
7319
|
-
* - If the
|
|
7320
|
-
* - If the
|
|
7321
|
-
* - When
|
|
7322
|
-
*
|
|
7323
|
-
* -
|
|
7324
|
-
* -
|
|
7325
|
-
* -
|
|
7326
|
-
* - If the
|
|
7327
|
-
* -
|
|
7328
|
-
* - You can create
|
|
7329
|
-
* - After a snapshot is created,
|
|
7330
|
-
* -
|
|
7331
|
-
* - The number of manual snapshots
|
|
7332
|
-
* -
|
|
7333
|
-
* - When you query
|
|
7316
|
+
* Creates a snapshot for a disk.
|
|
7317
|
+
*
|
|
7318
|
+
* @remarks
|
|
7319
|
+
* The local snapshot feature has been replaced by the snapshot instant access feature. Metric description is as follows:
|
|
7320
|
+
* - If you used local snapshots before December 14, 2020, you can use the `Category` parameter as Normal.
|
|
7321
|
+
* - 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.
|
|
7322
|
+
* Before you begin:
|
|
7323
|
+
* - Activate the snapshot feature. For more information, see [Activate snapshots](https://help.aliyun.com/document_detail/108381.html).
|
|
7324
|
+
* - The disk must be in the **In Use** or **Unattached** state. Note the following items for different states:
|
|
7325
|
+
* - If the disk is in the **In Use** state, the instance must be in the **Running** or **Stopped** state.
|
|
7326
|
+
* - 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.
|
|
7327
|
+
* - 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).
|
|
7328
|
+
* When you create a snapshot, take note of the following items:
|
|
7329
|
+
* - 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.
|
|
7330
|
+
* - 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)).
|
|
7331
|
+
* - Incremental data generated by disk operations during snapshot creation is not backup to the snapshot.
|
|
7332
|
+
* - 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.
|
|
7333
|
+
* - 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.
|
|
7334
|
+
* - 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.
|
|
7335
|
+
* - 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).
|
|
7336
|
+
* - In the following scenarios, you cannot create a snapshot for the specified disk:
|
|
7337
|
+
* - The number of manual snapshots retained for the disk has reached the upper limit. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
|
|
7338
|
+
* - Snapshot creation has concurrency limits. Exceeding the limits causes creation failures. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
|
|
7339
|
+
* - When you query ECS instance information, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
|
|
7334
7340
|
*
|
|
7335
7341
|
* @param request - CreateSnapshotRequest
|
|
7336
7342
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -7417,30 +7423,30 @@ export default class Client extends OpenApi {
|
|
|
7417
7423
|
}
|
|
7418
7424
|
|
|
7419
7425
|
/**
|
|
7420
|
-
*
|
|
7421
|
-
*
|
|
7422
|
-
* @remarks
|
|
7423
|
-
* The
|
|
7424
|
-
* - If you used local snapshots before December 14, 2020, you can
|
|
7425
|
-
* - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots
|
|
7426
|
-
*
|
|
7427
|
-
* -
|
|
7428
|
-
* - The
|
|
7429
|
-
* - If the
|
|
7430
|
-
* - If the
|
|
7431
|
-
* - When
|
|
7432
|
-
*
|
|
7433
|
-
* -
|
|
7434
|
-
* -
|
|
7435
|
-
* -
|
|
7436
|
-
* - If the
|
|
7437
|
-
* -
|
|
7438
|
-
* - You can create
|
|
7439
|
-
* - After a snapshot is created,
|
|
7440
|
-
* -
|
|
7441
|
-
* - The number of manual snapshots
|
|
7442
|
-
* -
|
|
7443
|
-
* - When you query
|
|
7426
|
+
* Creates a snapshot for a disk.
|
|
7427
|
+
*
|
|
7428
|
+
* @remarks
|
|
7429
|
+
* The local snapshot feature has been replaced by the snapshot instant access feature. Metric description is as follows:
|
|
7430
|
+
* - If you used local snapshots before December 14, 2020, you can use the `Category` parameter as Normal.
|
|
7431
|
+
* - 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.
|
|
7432
|
+
* Before you begin:
|
|
7433
|
+
* - Activate the snapshot feature. For more information, see [Activate snapshots](https://help.aliyun.com/document_detail/108381.html).
|
|
7434
|
+
* - The disk must be in the **In Use** or **Unattached** state. Note the following items for different states:
|
|
7435
|
+
* - If the disk is in the **In Use** state, the instance must be in the **Running** or **Stopped** state.
|
|
7436
|
+
* - 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.
|
|
7437
|
+
* - 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).
|
|
7438
|
+
* When you create a snapshot, take note of the following items:
|
|
7439
|
+
* - 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.
|
|
7440
|
+
* - 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)).
|
|
7441
|
+
* - Incremental data generated by disk operations during snapshot creation is not backup to the snapshot.
|
|
7442
|
+
* - 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.
|
|
7443
|
+
* - 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.
|
|
7444
|
+
* - 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.
|
|
7445
|
+
* - 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).
|
|
7446
|
+
* - In the following scenarios, you cannot create a snapshot for the specified disk:
|
|
7447
|
+
* - The number of manual snapshots retained for the disk has reached the upper limit. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
|
|
7448
|
+
* - Snapshot creation has concurrency limits. Exceeding the limits causes creation failures. For more information, see [Snapshot limits](~~25412#SnapshotQuota1~~).
|
|
7449
|
+
* - When you query ECS instance information, if the returned data contains `{"OperationLocks": {"LockReason" : "security"}}`, all operations are prohibited.
|
|
7444
7450
|
*
|
|
7445
7451
|
* @param request - CreateSnapshotRequest
|
|
7446
7452
|
* @returns CreateSnapshotResponse
|
|
@@ -7451,20 +7457,20 @@ export default class Client extends OpenApi {
|
|
|
7451
7457
|
}
|
|
7452
7458
|
|
|
7453
7459
|
/**
|
|
7454
|
-
* Creates a snapshot-consistent group for
|
|
7460
|
+
* Creates a snapshot-consistent group for disks attached to a specified ECS instance. A snapshot-consistent group contains snapshots of one or more disks.
|
|
7455
7461
|
*
|
|
7456
7462
|
* @remarks
|
|
7457
|
-
*
|
|
7458
|
-
* > `DiskId.N
|
|
7459
|
-
*
|
|
7460
|
-
* -
|
|
7461
|
-
*
|
|
7462
|
-
*
|
|
7463
|
-
* -
|
|
7464
|
-
* -
|
|
7465
|
-
* -
|
|
7466
|
-
* -
|
|
7467
|
-
*
|
|
7463
|
+
* 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.
|
|
7464
|
+
* > `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.
|
|
7465
|
+
* When you create a snapshot-consistent group, take note of the following items:
|
|
7466
|
+
* - The disks for which you want to create snapshots must be in the **In Use** (`In_use`) or **Available** (`Available`) state.
|
|
7467
|
+
* - If a disk is in the **In Use** (`In_use`) state, the ECS instance status must be **Running** (`Running`) or **Stopped** (`Stopped`).
|
|
7468
|
+
* - 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.
|
|
7469
|
+
* - Snapshot-consistent groups support only ESSD series disks (ESSD, ESSD AutoPL, and ESSD Entry).
|
|
7470
|
+
* - 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.
|
|
7471
|
+
* - 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.
|
|
7472
|
+
* - 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.
|
|
7473
|
+
* For more information about the features and billing of snapshot-consistent groups, see [Snapshot-consistent groups](https://help.aliyun.com/document_detail/199625.html).
|
|
7468
7474
|
*
|
|
7469
7475
|
* @param request - CreateSnapshotGroupRequest
|
|
7470
7476
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -7555,20 +7561,20 @@ export default class Client extends OpenApi {
|
|
|
7555
7561
|
}
|
|
7556
7562
|
|
|
7557
7563
|
/**
|
|
7558
|
-
* Creates a snapshot-consistent group for
|
|
7564
|
+
* Creates a snapshot-consistent group for disks attached to a specified ECS instance. A snapshot-consistent group contains snapshots of one or more disks.
|
|
7559
7565
|
*
|
|
7560
7566
|
* @remarks
|
|
7561
|
-
*
|
|
7562
|
-
* > `DiskId.N
|
|
7563
|
-
*
|
|
7564
|
-
* -
|
|
7565
|
-
*
|
|
7566
|
-
*
|
|
7567
|
-
* -
|
|
7568
|
-
* -
|
|
7569
|
-
* -
|
|
7570
|
-
* -
|
|
7571
|
-
*
|
|
7567
|
+
* 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.
|
|
7568
|
+
* > `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.
|
|
7569
|
+
* When you create a snapshot-consistent group, take note of the following items:
|
|
7570
|
+
* - The disks for which you want to create snapshots must be in the **In Use** (`In_use`) or **Available** (`Available`) state.
|
|
7571
|
+
* - If a disk is in the **In Use** (`In_use`) state, the ECS instance status must be **Running** (`Running`) or **Stopped** (`Stopped`).
|
|
7572
|
+
* - 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.
|
|
7573
|
+
* - Snapshot-consistent groups support only ESSD series disks (ESSD, ESSD AutoPL, and ESSD Entry).
|
|
7574
|
+
* - 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.
|
|
7575
|
+
* - 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.
|
|
7576
|
+
* - 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.
|
|
7577
|
+
* For more information about the features and billing of snapshot-consistent groups, see [Snapshot-consistent groups](https://help.aliyun.com/document_detail/199625.html).
|
|
7572
7578
|
*
|
|
7573
7579
|
* @param request - CreateSnapshotGroupRequest
|
|
7574
7580
|
* @returns CreateSnapshotGroupResponse
|
|
@@ -8661,13 +8667,13 @@ export default class Client extends OpenApi {
|
|
|
8661
8667
|
}
|
|
8662
8668
|
|
|
8663
8669
|
/**
|
|
8664
|
-
* Releases a pay-as-you-go data disk.
|
|
8670
|
+
* Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
|
|
8665
8671
|
*
|
|
8666
8672
|
* @remarks
|
|
8667
8673
|
* When you invoke this operation, take note of the following items:
|
|
8668
8674
|
* - Manual snapshots of the disk are retained.
|
|
8669
|
-
* - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to
|
|
8670
|
-
* - The disk must be in the
|
|
8675
|
+
* - 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.
|
|
8676
|
+
* - The disk must be in the Pending Attach (Available) state when you release it.
|
|
8671
8677
|
* - If the disk with the specified ID does not exist, the request is ignored.
|
|
8672
8678
|
*
|
|
8673
8679
|
* @param request - DeleteDiskRequest
|
|
@@ -8715,13 +8721,13 @@ export default class Client extends OpenApi {
|
|
|
8715
8721
|
}
|
|
8716
8722
|
|
|
8717
8723
|
/**
|
|
8718
|
-
* Releases a pay-as-you-go data disk.
|
|
8724
|
+
* Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
|
|
8719
8725
|
*
|
|
8720
8726
|
* @remarks
|
|
8721
8727
|
* When you invoke this operation, take note of the following items:
|
|
8722
8728
|
* - Manual snapshots of the disk are retained.
|
|
8723
|
-
* - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to
|
|
8724
|
-
* - The disk must be in the
|
|
8729
|
+
* - 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.
|
|
8730
|
+
* - The disk must be in the Pending Attach (Available) state when you release it.
|
|
8725
8731
|
* - If the disk with the specified ID does not exist, the request is ignored.
|
|
8726
8732
|
*
|
|
8727
8733
|
* @param request - DeleteDiskRequest
|
|
@@ -10312,13 +10318,13 @@ export default class Client extends OpenApi {
|
|
|
10312
10318
|
}
|
|
10313
10319
|
|
|
10314
10320
|
/**
|
|
10315
|
-
* Deletes a specified snapshot.
|
|
10321
|
+
* Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
|
|
10316
10322
|
*
|
|
10317
10323
|
* @remarks
|
|
10318
|
-
*
|
|
10319
|
-
* - If the snapshot does not exist, the request is ignored.
|
|
10320
|
-
* - If the snapshot has been used to create custom
|
|
10321
|
-
* - If the snapshot has been used to create
|
|
10324
|
+
* When you invoke this operation, note the following items:
|
|
10325
|
+
* - If the specified snapshot ID does not exist, the request is ignored.
|
|
10326
|
+
* - 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.
|
|
10327
|
+
* - 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.
|
|
10322
10328
|
*
|
|
10323
10329
|
* @param request - DeleteSnapshotRequest
|
|
10324
10330
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -10369,13 +10375,13 @@ export default class Client extends OpenApi {
|
|
|
10369
10375
|
}
|
|
10370
10376
|
|
|
10371
10377
|
/**
|
|
10372
|
-
* Deletes a specified snapshot.
|
|
10378
|
+
* Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
|
|
10373
10379
|
*
|
|
10374
10380
|
* @remarks
|
|
10375
|
-
*
|
|
10376
|
-
* - If the snapshot does not exist, the request is ignored.
|
|
10377
|
-
* - If the snapshot has been used to create custom
|
|
10378
|
-
* - If the snapshot has been used to create
|
|
10381
|
+
* When you invoke this operation, note the following items:
|
|
10382
|
+
* - If the specified snapshot ID does not exist, the request is ignored.
|
|
10383
|
+
* - 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.
|
|
10384
|
+
* - 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.
|
|
10379
10385
|
*
|
|
10380
10386
|
* @param request - DeleteSnapshotRequest
|
|
10381
10387
|
* @returns DeleteSnapshotResponse
|
|
@@ -10386,10 +10392,10 @@ export default class Client extends OpenApi {
|
|
|
10386
10392
|
}
|
|
10387
10393
|
|
|
10388
10394
|
/**
|
|
10389
|
-
* Deletes snapshot-consistent
|
|
10395
|
+
* Deletes a snapshot-consistent group.
|
|
10390
10396
|
*
|
|
10391
10397
|
* @remarks
|
|
10392
|
-
* If
|
|
10398
|
+
* 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)).
|
|
10393
10399
|
*
|
|
10394
10400
|
* @param request - DeleteSnapshotGroupRequest
|
|
10395
10401
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -10440,10 +10446,10 @@ export default class Client extends OpenApi {
|
|
|
10440
10446
|
}
|
|
10441
10447
|
|
|
10442
10448
|
/**
|
|
10443
|
-
* Deletes snapshot-consistent
|
|
10449
|
+
* Deletes a snapshot-consistent group.
|
|
10444
10450
|
*
|
|
10445
10451
|
* @remarks
|
|
10446
|
-
* If
|
|
10452
|
+
* 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)).
|
|
10447
10453
|
*
|
|
10448
10454
|
* @param request - DeleteSnapshotGroupRequest
|
|
10449
10455
|
* @returns DeleteSnapshotGroupResponse
|
|
@@ -13243,7 +13249,7 @@ export default class Client extends OpenApi {
|
|
|
13243
13249
|
}
|
|
13244
13250
|
|
|
13245
13251
|
/**
|
|
13246
|
-
* Queries the
|
|
13252
|
+
* Queries the key used for account-level default encryption of block storage.
|
|
13247
13253
|
*
|
|
13248
13254
|
* @param request - DescribeDiskDefaultKMSKeyIdRequest
|
|
13249
13255
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -13282,7 +13288,7 @@ export default class Client extends OpenApi {
|
|
|
13282
13288
|
}
|
|
13283
13289
|
|
|
13284
13290
|
/**
|
|
13285
|
-
* Queries the
|
|
13291
|
+
* Queries the key used for account-level default encryption of block storage.
|
|
13286
13292
|
*
|
|
13287
13293
|
* @param request - DescribeDiskDefaultKMSKeyIdRequest
|
|
13288
13294
|
* @returns DescribeDiskDefaultKMSKeyIdResponse
|
|
@@ -13293,7 +13299,7 @@ export default class Client extends OpenApi {
|
|
|
13293
13299
|
}
|
|
13294
13300
|
|
|
13295
13301
|
/**
|
|
13296
|
-
* Queries
|
|
13302
|
+
* Queries the service status of account-level default encryption for block storage in a specified region.
|
|
13297
13303
|
*
|
|
13298
13304
|
* @param request - DescribeDiskEncryptionByDefaultStatusRequest
|
|
13299
13305
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -13332,7 +13338,7 @@ export default class Client extends OpenApi {
|
|
|
13332
13338
|
}
|
|
13333
13339
|
|
|
13334
13340
|
/**
|
|
13335
|
-
* Queries
|
|
13341
|
+
* Queries the service status of account-level default encryption for block storage in a specified region.
|
|
13336
13342
|
*
|
|
13337
13343
|
* @param request - DescribeDiskEncryptionByDefaultStatusRequest
|
|
13338
13344
|
* @returns DescribeDiskEncryptionByDefaultStatusResponse
|
|
@@ -15003,7 +15009,7 @@ export default class Client extends OpenApi {
|
|
|
15003
15009
|
}
|
|
15004
15010
|
|
|
15005
15011
|
/**
|
|
15006
|
-
* Queries the list of
|
|
15012
|
+
* Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
|
|
15007
15013
|
*
|
|
15008
15014
|
* @remarks
|
|
15009
15015
|
* - 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.
|
|
@@ -15122,6 +15128,10 @@ export default class Client extends OpenApi {
|
|
|
15122
15128
|
query["Tag"] = request.tag;
|
|
15123
15129
|
}
|
|
15124
15130
|
|
|
15131
|
+
if (!$dara.isNull(request.usable)) {
|
|
15132
|
+
query["Usable"] = request.usable;
|
|
15133
|
+
}
|
|
15134
|
+
|
|
15125
15135
|
if (!$dara.isNull(request.usage)) {
|
|
15126
15136
|
query["Usage"] = request.usage;
|
|
15127
15137
|
}
|
|
@@ -15144,7 +15154,7 @@ export default class Client extends OpenApi {
|
|
|
15144
15154
|
}
|
|
15145
15155
|
|
|
15146
15156
|
/**
|
|
15147
|
-
* Queries the list of
|
|
15157
|
+
* Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
|
|
15148
15158
|
*
|
|
15149
15159
|
* @remarks
|
|
15150
15160
|
* - 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.
|
|
@@ -20214,13 +20224,13 @@ export default class Client extends OpenApi {
|
|
|
20214
20224
|
}
|
|
20215
20225
|
|
|
20216
20226
|
/**
|
|
20217
|
-
* Queries the list and status of files sent by Cloud Assistant
|
|
20227
|
+
* Queries the list and status of files sent by Cloud Assistant.
|
|
20218
20228
|
*
|
|
20219
20229
|
* @remarks
|
|
20220
20230
|
* ## Operation description:
|
|
20221
|
-
* - After you send a file, the file is not necessarily sent. You must check the actual
|
|
20222
|
-
* - You can query execution information from the last
|
|
20223
|
-
* - When
|
|
20231
|
+
* - 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.
|
|
20232
|
+
* - You can query execution information from the last day. A maximum of 1,000 entries of execution information can be retained.
|
|
20233
|
+
* - 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.
|
|
20224
20234
|
*
|
|
20225
20235
|
* @param request - DescribeSendFileResultsRequest
|
|
20226
20236
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -20311,13 +20321,13 @@ export default class Client extends OpenApi {
|
|
|
20311
20321
|
}
|
|
20312
20322
|
|
|
20313
20323
|
/**
|
|
20314
|
-
* Queries the list and status of files sent by Cloud Assistant
|
|
20324
|
+
* Queries the list and status of files sent by Cloud Assistant.
|
|
20315
20325
|
*
|
|
20316
20326
|
* @remarks
|
|
20317
20327
|
* ## Operation description:
|
|
20318
|
-
* - After you send a file, the file is not necessarily sent. You must check the actual
|
|
20319
|
-
* - You can query execution information from the last
|
|
20320
|
-
* - When
|
|
20328
|
+
* - 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.
|
|
20329
|
+
* - You can query execution information from the last day. A maximum of 1,000 entries of execution information can be retained.
|
|
20330
|
+
* - 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.
|
|
20321
20331
|
*
|
|
20322
20332
|
* @param request - DescribeSendFileResultsRequest
|
|
20323
20333
|
* @returns DescribeSendFileResultsResponse
|
|
@@ -20328,10 +20338,10 @@ export default class Client extends OpenApi {
|
|
|
20328
20338
|
}
|
|
20329
20339
|
|
|
20330
20340
|
/**
|
|
20331
|
-
* Queries
|
|
20341
|
+
* Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
|
|
20332
20342
|
*
|
|
20333
20343
|
* @remarks
|
|
20334
|
-
*
|
|
20344
|
+
* `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.
|
|
20335
20345
|
*
|
|
20336
20346
|
* @param request - DescribeSnapshotGroupsRequest
|
|
20337
20347
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -20414,10 +20424,10 @@ export default class Client extends OpenApi {
|
|
|
20414
20424
|
}
|
|
20415
20425
|
|
|
20416
20426
|
/**
|
|
20417
|
-
* Queries
|
|
20427
|
+
* Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
|
|
20418
20428
|
*
|
|
20419
20429
|
* @remarks
|
|
20420
|
-
*
|
|
20430
|
+
* `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.
|
|
20421
20431
|
*
|
|
20422
20432
|
* @param request - DescribeSnapshotGroupsRequest
|
|
20423
20433
|
* @returns DescribeSnapshotGroupsResponse
|
|
@@ -22883,14 +22893,14 @@ export default class Client extends OpenApi {
|
|
|
22883
22893
|
}
|
|
22884
22894
|
|
|
22885
22895
|
/**
|
|
22886
|
-
* Disables
|
|
22896
|
+
* Disables the account-level default encryption for block storage in a specified region.
|
|
22887
22897
|
*
|
|
22888
22898
|
* @remarks
|
|
22889
|
-
* - **
|
|
22890
|
-
* -
|
|
22891
|
-
* - **
|
|
22892
|
-
* - After
|
|
22893
|
-
* - After
|
|
22899
|
+
* - **Before you begin**
|
|
22900
|
+
* - 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).
|
|
22901
|
+
* - **Usage notes**
|
|
22902
|
+
* - After you shutdown account-level default encryption for block storage, the encryption status of existing cloud disks is not affected.
|
|
22903
|
+
* - After you shutdown account-level default encryption for block storage, you can still manually select encryption when you create cloud disks.
|
|
22894
22904
|
*
|
|
22895
22905
|
* @param request - DisableDiskEncryptionByDefaultRequest
|
|
22896
22906
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -22929,14 +22939,14 @@ export default class Client extends OpenApi {
|
|
|
22929
22939
|
}
|
|
22930
22940
|
|
|
22931
22941
|
/**
|
|
22932
|
-
* Disables
|
|
22942
|
+
* Disables the account-level default encryption for block storage in a specified region.
|
|
22933
22943
|
*
|
|
22934
22944
|
* @remarks
|
|
22935
|
-
* - **
|
|
22936
|
-
* -
|
|
22937
|
-
* - **
|
|
22938
|
-
* - After
|
|
22939
|
-
* - After
|
|
22945
|
+
* - **Before you begin**
|
|
22946
|
+
* - 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).
|
|
22947
|
+
* - **Usage notes**
|
|
22948
|
+
* - After you shutdown account-level default encryption for block storage, the encryption status of existing cloud disks is not affected.
|
|
22949
|
+
* - After you shutdown account-level default encryption for block storage, you can still manually select encryption when you create cloud disks.
|
|
22940
22950
|
*
|
|
22941
22951
|
* @param request - DisableDiskEncryptionByDefaultRequest
|
|
22942
22952
|
* @returns DisableDiskEncryptionByDefaultResponse
|