@alicloud/ecs20140526 7.9.0 → 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 +302 -298
- package/dist/client.js +305 -298
- 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 +55 -80
- package/dist/models/CloneDisksRequest.js.map +1 -1
- package/dist/models/CloneDisksResponseBody.d.ts +2 -2
- package/dist/models/CopySnapshotRequest.d.ts +17 -18
- package/dist/models/CopySnapshotRequest.js.map +1 -1
- package/dist/models/CreateAutoProvisioningGroupRequest.d.ts +286 -380
- package/dist/models/CreateAutoProvisioningGroupRequest.js.map +1 -1
- package/dist/models/CreateAutoProvisioningGroupShrinkRequest.d.ts +282 -375
- package/dist/models/CreateAutoProvisioningGroupShrinkRequest.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/CreateImageRequest.d.ts +43 -88
- package/dist/models/CreateImageRequest.js.map +1 -1
- package/dist/models/CreateImageResponseBody.d.ts +2 -2
- package/dist/models/CreateLaunchTemplateRequest.d.ts +235 -278
- package/dist/models/CreateLaunchTemplateRequest.js.map +1 -1
- package/dist/models/CreateLaunchTemplateResponseBody.d.ts +3 -3
- 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/CreateVswitchRequest.d.ts +0 -29
- package/dist/models/CreateVswitchRequest.js.map +1 -1
- package/dist/models/CreateVswitchResponseBody.d.ts +0 -8
- package/dist/models/CreateVswitchResponseBody.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 +61 -88
- package/dist/models/DescribeImagesRequest.js +2 -0
- package/dist/models/DescribeImagesRequest.js.map +1 -1
- package/dist/models/DescribeImagesResponseBody.d.ts +6 -5
- package/dist/models/DescribeImagesResponseBody.js +2 -0
- package/dist/models/DescribeImagesResponseBody.js.map +1 -1
- package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +4 -4
- 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/dist/models/RenewElasticityAssurancesRequest.d.ts +3 -3
- package/package.json +1 -1
- package/src/client.ts +306 -298
- 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 +55 -80
- package/src/models/CloneDisksResponseBody.ts +2 -2
- package/src/models/CopySnapshotRequest.ts +17 -18
- package/src/models/CreateAutoProvisioningGroupRequest.ts +287 -381
- package/src/models/CreateAutoProvisioningGroupShrinkRequest.ts +283 -376
- 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/CreateImageRequest.ts +43 -88
- package/src/models/CreateImageResponseBody.ts +2 -2
- package/src/models/CreateLaunchTemplateRequest.ts +235 -278
- package/src/models/CreateLaunchTemplateResponseBody.ts +3 -3
- package/src/models/CreateSnapshotGroupRequest.ts +23 -25
- package/src/models/CreateSnapshotRequest.ts +24 -29
- package/src/models/CreateVswitchRequest.ts +0 -29
- package/src/models/CreateVswitchResponseBody.ts +0 -8
- 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 +64 -89
- package/src/models/DescribeImagesResponseBody.ts +8 -5
- package/src/models/DescribeRecommendInstanceTypeRequest.ts +4 -4
- 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/models/RenewElasticityAssurancesRequest.ts +3 -3
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
|
|
1118
|
+
* Attaches a data disk or system disk to an ECS instance.
|
|
1119
1119
|
*
|
|
1120
1120
|
* @remarks
|
|
1121
|
-
*
|
|
1122
|
-
* - The
|
|
1123
|
-
* - The disk must be in the **
|
|
1124
|
-
* - When you attach
|
|
1125
|
-
*
|
|
1126
|
-
*
|
|
1127
|
-
*
|
|
1128
|
-
*
|
|
1129
|
-
* - When you attach
|
|
1130
|
-
*
|
|
1131
|
-
*
|
|
1132
|
-
*
|
|
1133
|
-
*
|
|
1134
|
-
*
|
|
1135
|
-
* -
|
|
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
|
|
1200
|
+
* Attaches a data disk or system disk to an ECS instance.
|
|
1198
1201
|
*
|
|
1199
1202
|
* @remarks
|
|
1200
|
-
*
|
|
1201
|
-
* - The
|
|
1202
|
-
* - The disk must be in the **
|
|
1203
|
-
* - When you attach
|
|
1204
|
-
*
|
|
1205
|
-
*
|
|
1206
|
-
*
|
|
1207
|
-
*
|
|
1208
|
-
* - When you attach
|
|
1209
|
-
*
|
|
1210
|
-
*
|
|
1211
|
-
*
|
|
1212
|
-
*
|
|
1213
|
-
*
|
|
1214
|
-
* -
|
|
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
|
|
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
|
|
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
|
|
2004
|
+
* Cancels an image building task.
|
|
1999
2005
|
*
|
|
2000
2006
|
* @remarks
|
|
2001
|
-
* Before you call this operation, make sure that the image
|
|
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
|
|
2057
|
+
* Cancels an image building task.
|
|
2052
2058
|
*
|
|
2053
2059
|
* @remarks
|
|
2054
|
-
* Before you call this operation, make sure that the image
|
|
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,29 +2240,29 @@ class Client extends openapi_core_1.default {
|
|
|
2234
2240
|
return await this.cancelTaskWithOptions(request, runtime);
|
|
2235
2241
|
}
|
|
2236
2242
|
/**
|
|
2237
|
-
*
|
|
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
|
|
2241
|
-
* ### Usage
|
|
2242
|
-
* - This is an asynchronous operation. After a successful call,
|
|
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
|
-
* -
|
|
2245
|
-
* -
|
|
2246
|
-
* - Local disks and elastic ephemeral disks
|
|
2247
|
-
* - You can specify the type and performance level
|
|
2248
|
-
* - You can specify the capacity
|
|
2249
|
-
* - You can configure provisioned performance and burst
|
|
2250
|
-
* - You can
|
|
2251
|
-
* - You can use a subscription
|
|
2252
|
-
* -
|
|
2253
|
-
* -
|
|
2254
|
-
* - `
|
|
2255
|
-
* - The `source disk`
|
|
2256
|
-
* - The `source disk`
|
|
2257
|
-
* -
|
|
2258
|
-
* -
|
|
2259
|
-
* -
|
|
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.
|
|
2252
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
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.
|
|
2260
|
+
* - `Source disk` status restrictions:
|
|
2261
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2262
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2263
|
+
* - Disks undergoing specification changes cannot be used as the `source disk`.
|
|
2264
|
+
* - Disks undergoing expansion cannot be used as the `source disk`.
|
|
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
|
|
2262
2268
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2336,29 +2342,29 @@ 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
|
-
*
|
|
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
|
|
2343
|
-
* ### Usage
|
|
2344
|
-
* - This is an asynchronous operation. After a successful call,
|
|
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
|
-
* -
|
|
2347
|
-
* -
|
|
2348
|
-
* - Local disks and elastic ephemeral disks
|
|
2349
|
-
* - You can specify the type and performance level
|
|
2350
|
-
* - You can specify the capacity
|
|
2351
|
-
* - You can configure provisioned performance and burst
|
|
2352
|
-
* - You can
|
|
2353
|
-
* - You can use a subscription
|
|
2354
|
-
* -
|
|
2355
|
-
* -
|
|
2356
|
-
* - `
|
|
2357
|
-
* - The `source disk`
|
|
2358
|
-
* - The `source disk`
|
|
2359
|
-
* -
|
|
2360
|
-
* -
|
|
2361
|
-
* -
|
|
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.
|
|
2354
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
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.
|
|
2362
|
+
* - `Source disk` status restrictions:
|
|
2363
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2364
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2365
|
+
* - Disks undergoing specification changes cannot be used as the `source disk`.
|
|
2366
|
+
* - Disks undergoing expansion cannot be used as the `source disk`.
|
|
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
|
|
2364
2370
|
* @returns CloneDisksResponse
|
|
@@ -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
|
|
2608
|
-
* -
|
|
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
|
|
2687
|
-
* -
|
|
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
|
|
@@ -2805,13 +2811,13 @@ class Client extends openapi_core_1.default {
|
|
|
2805
2811
|
return await this.createActivationWithOptions(request, runtime);
|
|
2806
2812
|
}
|
|
2807
2813
|
/**
|
|
2808
|
-
*
|
|
2814
|
+
* Creates an auto provisioning group.
|
|
2809
2815
|
*
|
|
2810
2816
|
* @remarks
|
|
2811
|
-
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create
|
|
2812
|
-
* - Auto provisioning
|
|
2813
|
-
* - Auto provisioning is a free feature
|
|
2814
|
-
* -
|
|
2817
|
+
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
|
|
2818
|
+
* - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
|
|
2819
|
+
* - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
|
|
2820
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
2815
2821
|
*
|
|
2816
2822
|
* @param tmpReq - CreateAutoProvisioningGroupRequest
|
|
2817
2823
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2953,13 +2959,13 @@ class Client extends openapi_core_1.default {
|
|
|
2953
2959
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoProvisioningGroupResponse({}));
|
|
2954
2960
|
}
|
|
2955
2961
|
/**
|
|
2956
|
-
*
|
|
2962
|
+
* Creates an auto provisioning group.
|
|
2957
2963
|
*
|
|
2958
2964
|
* @remarks
|
|
2959
|
-
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create
|
|
2960
|
-
* - Auto provisioning
|
|
2961
|
-
* - Auto provisioning is a free feature
|
|
2962
|
-
* -
|
|
2965
|
+
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
|
|
2966
|
+
* - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
|
|
2967
|
+
* - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
|
|
2968
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
2963
2969
|
*
|
|
2964
2970
|
* @param request - CreateAutoProvisioningGroupRequest
|
|
2965
2971
|
* @returns CreateAutoProvisioningGroupResponse
|
|
@@ -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
|
|
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,
|
|
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
|
|
2978
|
-
* -
|
|
2979
|
-
* - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are
|
|
2980
|
-
* After
|
|
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
|
|
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,
|
|
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
|
|
3057
|
-
* -
|
|
3058
|
-
* - If cross-region snapshot replication is enabled and no encryption parameters are configured, encrypted snapshots are
|
|
3059
|
-
* After
|
|
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
|
-
* -
|
|
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
|
-
* -
|
|
3565
|
-
* - Creating a disk incurs
|
|
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
|
|
3568
|
-
* - When you create an enterprise SSD, if you do not configure
|
|
3569
|
-
* - The billing method is pay-as-you-go
|
|
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
|
-
* -
|
|
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
|
-
* -
|
|
3682
|
-
* - Creating a disk incurs
|
|
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
|
|
3685
|
-
* - When you create an enterprise SSD, if you do not configure
|
|
3686
|
-
* - The billing method is pay-as-you-go
|
|
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
|
|
@@ -4009,26 +4015,25 @@ class Client extends openapi_core_1.default {
|
|
|
4009
4015
|
return await this.createHpcClusterWithOptions(request, runtime);
|
|
4010
4016
|
}
|
|
4011
4017
|
/**
|
|
4012
|
-
*
|
|
4018
|
+
* Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
|
|
4013
4019
|
*
|
|
4014
4020
|
* @remarks
|
|
4015
|
-
* ###
|
|
4016
|
-
* - This
|
|
4017
|
-
* -
|
|
4018
|
-
* -
|
|
4019
|
-
*
|
|
4021
|
+
* ### Before you begin
|
|
4022
|
+
* - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
|
|
4023
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
4024
|
+
* - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
|
|
4025
|
+
* The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
|
|
4020
4026
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
4021
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
4022
|
-
* -
|
|
4023
|
-
* >Notice:
|
|
4024
|
-
*
|
|
4025
|
-
*
|
|
4026
|
-
*
|
|
4027
|
-
*
|
|
4028
|
-
*
|
|
4029
|
-
*
|
|
4030
|
-
*
|
|
4031
|
-
* > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
|
|
4027
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
4028
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
4029
|
+
* >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
|
|
4030
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
4031
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
4032
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
4033
|
+
* - Only one system disk snapshot can be specified.
|
|
4034
|
+
* - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
|
|
4035
|
+
*
|
|
4036
|
+
* > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
|
|
4032
4037
|
*
|
|
4033
4038
|
* @param request - CreateImageRequest
|
|
4034
4039
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4117,26 +4122,25 @@ class Client extends openapi_core_1.default {
|
|
|
4117
4122
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateImageResponse({}));
|
|
4118
4123
|
}
|
|
4119
4124
|
/**
|
|
4120
|
-
*
|
|
4125
|
+
* Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
|
|
4121
4126
|
*
|
|
4122
4127
|
* @remarks
|
|
4123
|
-
* ###
|
|
4124
|
-
* - This
|
|
4125
|
-
* -
|
|
4126
|
-
* -
|
|
4127
|
-
*
|
|
4128
|
+
* ### Before you begin
|
|
4129
|
+
* - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
|
|
4130
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
4131
|
+
* - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
|
|
4132
|
+
* The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
|
|
4128
4133
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
4129
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
4130
|
-
* -
|
|
4131
|
-
* >Notice:
|
|
4132
|
-
*
|
|
4133
|
-
*
|
|
4134
|
-
*
|
|
4135
|
-
*
|
|
4136
|
-
*
|
|
4137
|
-
*
|
|
4138
|
-
*
|
|
4139
|
-
* > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
|
|
4134
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
4135
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
4136
|
+
* >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
|
|
4137
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
4138
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
4139
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
4140
|
+
* - Only one system disk snapshot can be specified.
|
|
4141
|
+
* - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
|
|
4142
|
+
*
|
|
4143
|
+
* > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
|
|
4140
4144
|
*
|
|
4141
4145
|
* @param request - CreateImageRequest
|
|
4142
4146
|
* @returns CreateImageResponse
|
|
@@ -4728,15 +4732,15 @@ class Client extends openapi_core_1.default {
|
|
|
4728
4732
|
return await this.createKeyPairWithOptions(request, runtime);
|
|
4729
4733
|
}
|
|
4730
4734
|
/**
|
|
4731
|
-
*
|
|
4735
|
+
* Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
|
|
4732
4736
|
*
|
|
4733
4737
|
* @remarks
|
|
4734
|
-
* After you
|
|
4735
|
-
* A launch template version
|
|
4736
|
-
* When
|
|
4737
|
-
* -
|
|
4738
|
-
* -
|
|
4739
|
-
* -
|
|
4738
|
+
* After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
|
|
4739
|
+
* A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
|
|
4740
|
+
* When you call this operation, take note of the following items:
|
|
4741
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
4742
|
+
* - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
|
|
4743
|
+
* - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
|
|
4740
4744
|
*
|
|
4741
4745
|
* @param request - CreateLaunchTemplateRequest
|
|
4742
4746
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4930,15 +4934,15 @@ class Client extends openapi_core_1.default {
|
|
|
4930
4934
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLaunchTemplateResponse({}));
|
|
4931
4935
|
}
|
|
4932
4936
|
/**
|
|
4933
|
-
*
|
|
4937
|
+
* Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
|
|
4934
4938
|
*
|
|
4935
4939
|
* @remarks
|
|
4936
|
-
* After you
|
|
4937
|
-
* A launch template version
|
|
4938
|
-
* When
|
|
4939
|
-
* -
|
|
4940
|
-
* -
|
|
4941
|
-
* -
|
|
4940
|
+
* After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
|
|
4941
|
+
* A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
|
|
4942
|
+
* When you call this operation, take note of the following items:
|
|
4943
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
4944
|
+
* - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
|
|
4945
|
+
* - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
|
|
4942
4946
|
*
|
|
4943
4947
|
* @param request - CreateLaunchTemplateRequest
|
|
4944
4948
|
* @returns CreateLaunchTemplateResponse
|
|
@@ -6260,30 +6264,30 @@ class Client extends openapi_core_1.default {
|
|
|
6260
6264
|
return await this.createSimulatedSystemEventsWithOptions(request, runtime);
|
|
6261
6265
|
}
|
|
6262
6266
|
/**
|
|
6263
|
-
*
|
|
6264
|
-
*
|
|
6265
|
-
* @remarks
|
|
6266
|
-
* The
|
|
6267
|
-
* - If you used local snapshots before December 14, 2020, you can
|
|
6268
|
-
* - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots
|
|
6269
|
-
*
|
|
6270
|
-
* -
|
|
6271
|
-
* - The
|
|
6272
|
-
* - If the
|
|
6273
|
-
* - If the
|
|
6274
|
-
* - When
|
|
6275
|
-
*
|
|
6276
|
-
* -
|
|
6277
|
-
* -
|
|
6278
|
-
* -
|
|
6279
|
-
* - If the
|
|
6280
|
-
* -
|
|
6281
|
-
* - You can create
|
|
6282
|
-
* - After a snapshot is created,
|
|
6283
|
-
* -
|
|
6284
|
-
* - The number of manual snapshots
|
|
6285
|
-
* -
|
|
6286
|
-
* - When you query
|
|
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.
|
|
6287
6291
|
*
|
|
6288
6292
|
* @param request - CreateSnapshotRequest
|
|
6289
6293
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -6354,30 +6358,30 @@ class Client extends openapi_core_1.default {
|
|
|
6354
6358
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateSnapshotResponse({}));
|
|
6355
6359
|
}
|
|
6356
6360
|
/**
|
|
6357
|
-
*
|
|
6358
|
-
*
|
|
6359
|
-
* @remarks
|
|
6360
|
-
* The
|
|
6361
|
-
* - If you used local snapshots before December 14, 2020, you can
|
|
6362
|
-
* - If you did not use local snapshots before December 14, 2020, no additional configuration is required. New snapshots
|
|
6363
|
-
*
|
|
6364
|
-
* -
|
|
6365
|
-
* - The
|
|
6366
|
-
* - If the
|
|
6367
|
-
* - If the
|
|
6368
|
-
* - When
|
|
6369
|
-
*
|
|
6370
|
-
* -
|
|
6371
|
-
* -
|
|
6372
|
-
* -
|
|
6373
|
-
* - If the
|
|
6374
|
-
* -
|
|
6375
|
-
* - You can create
|
|
6376
|
-
* - After a snapshot is created,
|
|
6377
|
-
* -
|
|
6378
|
-
* - The number of manual snapshots
|
|
6379
|
-
* -
|
|
6380
|
-
* - When you query
|
|
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.
|
|
6381
6385
|
*
|
|
6382
6386
|
* @param request - CreateSnapshotRequest
|
|
6383
6387
|
* @returns CreateSnapshotResponse
|
|
@@ -6387,20 +6391,20 @@ class Client extends openapi_core_1.default {
|
|
|
6387
6391
|
return await this.createSnapshotWithOptions(request, runtime);
|
|
6388
6392
|
}
|
|
6389
6393
|
/**
|
|
6390
|
-
* Creates a snapshot-consistent group for
|
|
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.
|
|
6391
6395
|
*
|
|
6392
6396
|
* @remarks
|
|
6393
|
-
*
|
|
6394
|
-
* > `DiskId.N
|
|
6395
|
-
*
|
|
6396
|
-
* -
|
|
6397
|
-
*
|
|
6398
|
-
*
|
|
6399
|
-
* -
|
|
6400
|
-
* -
|
|
6401
|
-
* -
|
|
6402
|
-
* -
|
|
6403
|
-
*
|
|
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).
|
|
6404
6408
|
*
|
|
6405
6409
|
* @param request - CreateSnapshotGroupRequest
|
|
6406
6410
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -6474,20 +6478,20 @@ class Client extends openapi_core_1.default {
|
|
|
6474
6478
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateSnapshotGroupResponse({}));
|
|
6475
6479
|
}
|
|
6476
6480
|
/**
|
|
6477
|
-
* Creates a snapshot-consistent group for
|
|
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.
|
|
6478
6482
|
*
|
|
6479
6483
|
* @remarks
|
|
6480
|
-
*
|
|
6481
|
-
* > `DiskId.N
|
|
6482
|
-
*
|
|
6483
|
-
* -
|
|
6484
|
-
*
|
|
6485
|
-
*
|
|
6486
|
-
* -
|
|
6487
|
-
* -
|
|
6488
|
-
* -
|
|
6489
|
-
* -
|
|
6490
|
-
*
|
|
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).
|
|
6491
6495
|
*
|
|
6492
6496
|
* @param request - CreateSnapshotGroupRequest
|
|
6493
6497
|
* @returns CreateSnapshotGroupResponse
|
|
@@ -7433,13 +7437,13 @@ class Client extends openapi_core_1.default {
|
|
|
7433
7437
|
return await this.deleteDiagnosticReportsWithOptions(request, runtime);
|
|
7434
7438
|
}
|
|
7435
7439
|
/**
|
|
7436
|
-
* Releases a pay-as-you-go data disk.
|
|
7440
|
+
* Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
|
|
7437
7441
|
*
|
|
7438
7442
|
* @remarks
|
|
7439
7443
|
* When you invoke this operation, take note of the following items:
|
|
7440
7444
|
* - Manual snapshots of the disk are retained.
|
|
7441
|
-
* - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to
|
|
7442
|
-
* - The disk must be in the
|
|
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.
|
|
7443
7447
|
* - If the disk with the specified ID does not exist, the request is ignored.
|
|
7444
7448
|
*
|
|
7445
7449
|
* @param request - DeleteDiskRequest
|
|
@@ -7481,13 +7485,13 @@ class Client extends openapi_core_1.default {
|
|
|
7481
7485
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteDiskResponse({}));
|
|
7482
7486
|
}
|
|
7483
7487
|
/**
|
|
7484
|
-
* Releases a pay-as-you-go data disk.
|
|
7488
|
+
* Releases a pay-as-you-go data disk. Disk types include basic disks, ultra disks, standard SSDs, and enterprise SSDs.
|
|
7485
7489
|
*
|
|
7486
7490
|
* @remarks
|
|
7487
7491
|
* When you invoke this operation, take note of the following items:
|
|
7488
7492
|
* - Manual snapshots of the disk are retained.
|
|
7489
|
-
* - You can invoke [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to
|
|
7490
|
-
* - The disk must be in the
|
|
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.
|
|
7491
7495
|
* - If the disk with the specified ID does not exist, the request is ignored.
|
|
7492
7496
|
*
|
|
7493
7497
|
* @param request - DeleteDiskRequest
|
|
@@ -8884,13 +8888,13 @@ class Client extends openapi_core_1.default {
|
|
|
8884
8888
|
return await this.deleteSecurityGroupWithOptions(request, runtime);
|
|
8885
8889
|
}
|
|
8886
8890
|
/**
|
|
8887
|
-
* Deletes a specified snapshot.
|
|
8891
|
+
* Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
|
|
8888
8892
|
*
|
|
8889
8893
|
* @remarks
|
|
8890
|
-
*
|
|
8891
|
-
* - If the snapshot does not exist, the request is ignored.
|
|
8892
|
-
* - If the snapshot has been used to create custom
|
|
8893
|
-
* - If the snapshot has been used to create
|
|
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.
|
|
8894
8898
|
*
|
|
8895
8899
|
* @param request - DeleteSnapshotRequest
|
|
8896
8900
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -8934,13 +8938,13 @@ class Client extends openapi_core_1.default {
|
|
|
8934
8938
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteSnapshotResponse({}));
|
|
8935
8939
|
}
|
|
8936
8940
|
/**
|
|
8937
|
-
* Deletes a specified snapshot.
|
|
8941
|
+
* Deletes a specified snapshot. You can also call this operation to cancel a snapshot that is being created.
|
|
8938
8942
|
*
|
|
8939
8943
|
* @remarks
|
|
8940
|
-
*
|
|
8941
|
-
* - If the snapshot does not exist, the request is ignored.
|
|
8942
|
-
* - If the snapshot has been used to create custom
|
|
8943
|
-
* - If the snapshot has been used to create
|
|
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.
|
|
8944
8948
|
*
|
|
8945
8949
|
* @param request - DeleteSnapshotRequest
|
|
8946
8950
|
* @returns DeleteSnapshotResponse
|
|
@@ -8950,10 +8954,10 @@ class Client extends openapi_core_1.default {
|
|
|
8950
8954
|
return await this.deleteSnapshotWithOptions(request, runtime);
|
|
8951
8955
|
}
|
|
8952
8956
|
/**
|
|
8953
|
-
* Deletes snapshot-consistent
|
|
8957
|
+
* Deletes a snapshot-consistent group.
|
|
8954
8958
|
*
|
|
8955
8959
|
* @remarks
|
|
8956
|
-
* If
|
|
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)).
|
|
8957
8961
|
*
|
|
8958
8962
|
* @param request - DeleteSnapshotGroupRequest
|
|
8959
8963
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -8997,10 +9001,10 @@ class Client extends openapi_core_1.default {
|
|
|
8997
9001
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteSnapshotGroupResponse({}));
|
|
8998
9002
|
}
|
|
8999
9003
|
/**
|
|
9000
|
-
* Deletes snapshot-consistent
|
|
9004
|
+
* Deletes a snapshot-consistent group.
|
|
9001
9005
|
*
|
|
9002
9006
|
* @remarks
|
|
9003
|
-
* If
|
|
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)).
|
|
9004
9008
|
*
|
|
9005
9009
|
* @param request - DeleteSnapshotGroupRequest
|
|
9006
9010
|
* @returns DeleteSnapshotGroupResponse
|
|
@@ -11410,7 +11414,7 @@ class Client extends openapi_core_1.default {
|
|
|
11410
11414
|
return await this.describeDiagnosticReportsWithOptions(request, runtime);
|
|
11411
11415
|
}
|
|
11412
11416
|
/**
|
|
11413
|
-
* Queries the
|
|
11417
|
+
* Queries the key used for account-level default encryption of block storage.
|
|
11414
11418
|
*
|
|
11415
11419
|
* @param request - DescribeDiskDefaultKMSKeyIdRequest
|
|
11416
11420
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -11445,7 +11449,7 @@ class Client extends openapi_core_1.default {
|
|
|
11445
11449
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeDiskDefaultKMSKeyIdResponse({}));
|
|
11446
11450
|
}
|
|
11447
11451
|
/**
|
|
11448
|
-
* Queries the
|
|
11452
|
+
* Queries the key used for account-level default encryption of block storage.
|
|
11449
11453
|
*
|
|
11450
11454
|
* @param request - DescribeDiskDefaultKMSKeyIdRequest
|
|
11451
11455
|
* @returns DescribeDiskDefaultKMSKeyIdResponse
|
|
@@ -11455,7 +11459,7 @@ class Client extends openapi_core_1.default {
|
|
|
11455
11459
|
return await this.describeDiskDefaultKMSKeyIdWithOptions(request, runtime);
|
|
11456
11460
|
}
|
|
11457
11461
|
/**
|
|
11458
|
-
* Queries
|
|
11462
|
+
* Queries the service status of account-level default encryption for block storage in a specified region.
|
|
11459
11463
|
*
|
|
11460
11464
|
* @param request - DescribeDiskEncryptionByDefaultStatusRequest
|
|
11461
11465
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -11490,7 +11494,7 @@ class Client extends openapi_core_1.default {
|
|
|
11490
11494
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeDiskEncryptionByDefaultStatusResponse({}));
|
|
11491
11495
|
}
|
|
11492
11496
|
/**
|
|
11493
|
-
* Queries
|
|
11497
|
+
* Queries the service status of account-level default encryption for block storage in a specified region.
|
|
11494
11498
|
*
|
|
11495
11499
|
* @param request - DescribeDiskEncryptionByDefaultStatusRequest
|
|
11496
11500
|
* @returns DescribeDiskEncryptionByDefaultStatusResponse
|
|
@@ -12911,13 +12915,13 @@ class Client extends openapi_core_1.default {
|
|
|
12911
12915
|
return await this.describeImageSupportInstanceTypesWithOptions(request, runtime);
|
|
12912
12916
|
}
|
|
12913
12917
|
/**
|
|
12914
|
-
*
|
|
12918
|
+
* Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
|
|
12915
12919
|
*
|
|
12916
12920
|
* @remarks
|
|
12917
|
-
* -
|
|
12918
|
-
* -
|
|
12919
|
-
* - When
|
|
12920
|
-
* - When
|
|
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.
|
|
12922
|
+
* - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
|
|
12923
|
+
* - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
|
|
12924
|
+
* - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
|
|
12921
12925
|
*
|
|
12922
12926
|
* @param request - DescribeImagesRequest
|
|
12923
12927
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -13004,6 +13008,9 @@ class Client extends openapi_core_1.default {
|
|
|
13004
13008
|
if (!$dara.isNull(request.tag)) {
|
|
13005
13009
|
query["Tag"] = request.tag;
|
|
13006
13010
|
}
|
|
13011
|
+
if (!$dara.isNull(request.usable)) {
|
|
13012
|
+
query["Usable"] = request.usable;
|
|
13013
|
+
}
|
|
13007
13014
|
if (!$dara.isNull(request.usage)) {
|
|
13008
13015
|
query["Usage"] = request.usage;
|
|
13009
13016
|
}
|
|
@@ -13024,13 +13031,13 @@ class Client extends openapi_core_1.default {
|
|
|
13024
13031
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeImagesResponse({}));
|
|
13025
13032
|
}
|
|
13026
13033
|
/**
|
|
13027
|
-
*
|
|
13034
|
+
* Queries the list of image resources that you can use by specifying parameters such as ImageId, image usage scenarios, and Filter conditions.
|
|
13028
13035
|
*
|
|
13029
13036
|
* @remarks
|
|
13030
|
-
* -
|
|
13031
|
-
* -
|
|
13032
|
-
* - When
|
|
13033
|
-
* - When
|
|
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.
|
|
13038
|
+
* - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
|
|
13039
|
+
* - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
|
|
13040
|
+
* - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
|
|
13034
13041
|
*
|
|
13035
13042
|
* @param request - DescribeImagesRequest
|
|
13036
13043
|
* @returns DescribeImagesResponse
|
|
@@ -16190,7 +16197,7 @@ class Client extends openapi_core_1.default {
|
|
|
16190
16197
|
return await this.describePriceWithOptions(request, runtime);
|
|
16191
16198
|
}
|
|
16192
16199
|
/**
|
|
16193
|
-
*
|
|
16200
|
+
* (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
|
|
16194
16201
|
*
|
|
16195
16202
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
16196
16203
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -16276,7 +16283,7 @@ class Client extends openapi_core_1.default {
|
|
|
16276
16283
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeRecommendInstanceTypeResponse({}));
|
|
16277
16284
|
}
|
|
16278
16285
|
/**
|
|
16279
|
-
*
|
|
16286
|
+
* (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
|
|
16280
16287
|
*
|
|
16281
16288
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
16282
16289
|
* @returns DescribeRecommendInstanceTypeResponse
|
|
@@ -17335,13 +17342,13 @@ class Client extends openapi_core_1.default {
|
|
|
17335
17342
|
return await this.describeSecurityGroupsWithOptions(request, runtime);
|
|
17336
17343
|
}
|
|
17337
17344
|
/**
|
|
17338
|
-
* Queries the list and status of files sent by Cloud Assistant
|
|
17345
|
+
* Queries the list and status of files sent by Cloud Assistant.
|
|
17339
17346
|
*
|
|
17340
17347
|
* @remarks
|
|
17341
17348
|
* ## Operation description:
|
|
17342
|
-
* - After you send a file, the file is not necessarily sent. You must check the actual
|
|
17343
|
-
* - You can query execution information from the last
|
|
17344
|
-
* - When
|
|
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.
|
|
17345
17352
|
*
|
|
17346
17353
|
* @param request - DescribeSendFileResultsRequest
|
|
17347
17354
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -17415,13 +17422,13 @@ class Client extends openapi_core_1.default {
|
|
|
17415
17422
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSendFileResultsResponse({}));
|
|
17416
17423
|
}
|
|
17417
17424
|
/**
|
|
17418
|
-
* Queries the list and status of files sent by Cloud Assistant
|
|
17425
|
+
* Queries the list and status of files sent by Cloud Assistant.
|
|
17419
17426
|
*
|
|
17420
17427
|
* @remarks
|
|
17421
17428
|
* ## Operation description:
|
|
17422
|
-
* - After you send a file, the file is not necessarily sent. You must check the actual
|
|
17423
|
-
* - You can query execution information from the last
|
|
17424
|
-
* - When
|
|
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.
|
|
17425
17432
|
*
|
|
17426
17433
|
* @param request - DescribeSendFileResultsRequest
|
|
17427
17434
|
* @returns DescribeSendFileResultsResponse
|
|
@@ -17431,10 +17438,10 @@ class Client extends openapi_core_1.default {
|
|
|
17431
17438
|
return await this.describeSendFileResultsWithOptions(request, runtime);
|
|
17432
17439
|
}
|
|
17433
17440
|
/**
|
|
17434
|
-
* Queries
|
|
17441
|
+
* Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
|
|
17435
17442
|
*
|
|
17436
17443
|
* @remarks
|
|
17437
|
-
*
|
|
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.
|
|
17438
17445
|
*
|
|
17439
17446
|
* @param request - DescribeSnapshotGroupsRequest
|
|
17440
17447
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -17502,10 +17509,10 @@ class Client extends openapi_core_1.default {
|
|
|
17502
17509
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSnapshotGroupsResponse({}));
|
|
17503
17510
|
}
|
|
17504
17511
|
/**
|
|
17505
|
-
* Queries
|
|
17512
|
+
* Queries information about one or more snapshot-consistent groups, such as the status, associated instance ID, and snapshot creation progress.
|
|
17506
17513
|
*
|
|
17507
17514
|
* @remarks
|
|
17508
|
-
*
|
|
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.
|
|
17509
17516
|
*
|
|
17510
17517
|
* @param request - DescribeSnapshotGroupsRequest
|
|
17511
17518
|
* @returns DescribeSnapshotGroupsResponse
|
|
@@ -19634,14 +19641,14 @@ class Client extends openapi_core_1.default {
|
|
|
19634
19641
|
return await this.disableActivationWithOptions(request, runtime);
|
|
19635
19642
|
}
|
|
19636
19643
|
/**
|
|
19637
|
-
* Disables
|
|
19644
|
+
* Disables the account-level default encryption for block storage in a specified region.
|
|
19638
19645
|
*
|
|
19639
19646
|
* @remarks
|
|
19640
|
-
* - **
|
|
19641
|
-
* -
|
|
19642
|
-
* - **
|
|
19643
|
-
* - After
|
|
19644
|
-
* - After
|
|
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.
|
|
19645
19652
|
*
|
|
19646
19653
|
* @param request - DisableDiskEncryptionByDefaultRequest
|
|
19647
19654
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -19676,14 +19683,14 @@ class Client extends openapi_core_1.default {
|
|
|
19676
19683
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DisableDiskEncryptionByDefaultResponse({}));
|
|
19677
19684
|
}
|
|
19678
19685
|
/**
|
|
19679
|
-
* Disables
|
|
19686
|
+
* Disables the account-level default encryption for block storage in a specified region.
|
|
19680
19687
|
*
|
|
19681
19688
|
* @remarks
|
|
19682
|
-
* - **
|
|
19683
|
-
* -
|
|
19684
|
-
* - **
|
|
19685
|
-
* - After
|
|
19686
|
-
* - After
|
|
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.
|
|
19687
19694
|
*
|
|
19688
19695
|
* @param request - DisableDiskEncryptionByDefaultRequest
|
|
19689
19696
|
* @returns DisableDiskEncryptionByDefaultResponse
|