@alicloud/ecs20140526 7.9.0 → 7.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client.d.ts +108 -110
- package/dist/client.js +108 -110
- package/dist/client.js.map +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/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/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/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/DescribeImagesRequest.d.ts +61 -89
- package/dist/models/DescribeImagesRequest.js.map +1 -1
- package/dist/models/DescribeImagesResponseBody.d.ts +5 -5
- package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +4 -4
- package/dist/models/RenewElasticityAssurancesRequest.d.ts +3 -3
- package/package.json +1 -1
- package/src/client.ts +108 -110
- package/src/models/CloneDisksRequest.ts +55 -80
- package/src/models/CloneDisksResponseBody.ts +2 -2
- package/src/models/CreateAutoProvisioningGroupRequest.ts +287 -381
- package/src/models/CreateAutoProvisioningGroupShrinkRequest.ts +283 -376
- 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/CreateVswitchRequest.ts +0 -29
- package/src/models/CreateVswitchResponseBody.ts +0 -8
- package/src/models/DescribeImagesRequest.ts +62 -90
- package/src/models/DescribeImagesResponseBody.ts +5 -5
- package/src/models/DescribeRecommendInstanceTypeRequest.ts +4 -4
- package/src/models/RenewElasticityAssurancesRequest.ts +3 -3
package/dist/client.d.ts
CHANGED
|
@@ -818,29 +818,29 @@ export default class Client extends OpenApi {
|
|
|
818
818
|
*/
|
|
819
819
|
cancelTask(request: $_model.CancelTaskRequest): Promise<$_model.CancelTaskResponse>;
|
|
820
820
|
/**
|
|
821
|
-
*
|
|
821
|
+
* Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
|
|
822
822
|
*
|
|
823
823
|
* @remarks
|
|
824
|
-
* > The
|
|
825
|
-
* ###
|
|
826
|
-
* - This is an asynchronous operation. After a successful call,
|
|
824
|
+
* > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
|
|
825
|
+
* ### How to use
|
|
826
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
|
|
827
827
|
* ### Features
|
|
828
|
-
* -
|
|
829
|
-
* -
|
|
830
|
-
* - Local disks and elastic ephemeral disks
|
|
831
|
-
* - You can specify the type and performance level
|
|
832
|
-
* - You can specify the capacity
|
|
833
|
-
* - You can configure provisioned performance and burst
|
|
834
|
-
* - You can
|
|
835
|
-
* - You can use a subscription
|
|
836
|
-
* -
|
|
837
|
-
* -
|
|
838
|
-
* - `
|
|
839
|
-
* - The `source disk`
|
|
840
|
-
* - The `source disk`
|
|
841
|
-
* - A disk undergoing a
|
|
842
|
-
* - A disk
|
|
843
|
-
* -
|
|
828
|
+
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
|
|
829
|
+
* - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
|
|
830
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
831
|
+
* - You can specify the `new disk` type and performance level (PL) during cloning.
|
|
832
|
+
* - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
833
|
+
* - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
|
|
834
|
+
* - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
|
|
835
|
+
* - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
|
|
836
|
+
* - The `new disk` created by cloning does not support reinitialization.
|
|
837
|
+
* - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
|
|
838
|
+
* - `Source disk` status restrictions:
|
|
839
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
840
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
841
|
+
* - A disk undergoing a specification change cannot be used as the `source disk`.
|
|
842
|
+
* - A disk undergoing expansion cannot be used as the `source disk`.
|
|
843
|
+
* - 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`.
|
|
844
844
|
*
|
|
845
845
|
* @param request - CloneDisksRequest
|
|
846
846
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -848,29 +848,29 @@ export default class Client extends OpenApi {
|
|
|
848
848
|
*/
|
|
849
849
|
cloneDisksWithOptions(request: $_model.CloneDisksRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CloneDisksResponse>;
|
|
850
850
|
/**
|
|
851
|
-
*
|
|
851
|
+
* Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
|
|
852
852
|
*
|
|
853
853
|
* @remarks
|
|
854
|
-
* > The
|
|
855
|
-
* ###
|
|
856
|
-
* - This is an asynchronous operation. After a successful call,
|
|
854
|
+
* > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
|
|
855
|
+
* ### How to use
|
|
856
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
|
|
857
857
|
* ### Features
|
|
858
|
-
* -
|
|
859
|
-
* -
|
|
860
|
-
* - Local disks and elastic ephemeral disks
|
|
861
|
-
* - You can specify the type and performance level
|
|
862
|
-
* - You can specify the capacity
|
|
863
|
-
* - You can configure provisioned performance and burst
|
|
864
|
-
* - You can
|
|
865
|
-
* - You can use a subscription
|
|
866
|
-
* -
|
|
867
|
-
* -
|
|
868
|
-
* - `
|
|
869
|
-
* - The `source disk`
|
|
870
|
-
* - The `source disk`
|
|
871
|
-
* - A disk undergoing a
|
|
872
|
-
* - A disk
|
|
873
|
-
* -
|
|
858
|
+
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
|
|
859
|
+
* - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
|
|
860
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
861
|
+
* - You can specify the `new disk` type and performance level (PL) during cloning.
|
|
862
|
+
* - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
863
|
+
* - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
|
|
864
|
+
* - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
|
|
865
|
+
* - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
|
|
866
|
+
* - The `new disk` created by cloning does not support reinitialization.
|
|
867
|
+
* - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
|
|
868
|
+
* - `Source disk` status restrictions:
|
|
869
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
870
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
871
|
+
* - A disk undergoing a specification change cannot be used as the `source disk`.
|
|
872
|
+
* - A disk undergoing expansion cannot be used as the `source disk`.
|
|
873
|
+
* - 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`.
|
|
874
874
|
*
|
|
875
875
|
* @param request - CloneDisksRequest
|
|
876
876
|
* @returns CloneDisksResponse
|
|
@@ -1040,13 +1040,13 @@ export default class Client extends OpenApi {
|
|
|
1040
1040
|
*/
|
|
1041
1041
|
createActivation(request: $_model.CreateActivationRequest): Promise<$_model.CreateActivationResponse>;
|
|
1042
1042
|
/**
|
|
1043
|
-
*
|
|
1043
|
+
* Creates an auto provisioning group.
|
|
1044
1044
|
*
|
|
1045
1045
|
* @remarks
|
|
1046
|
-
* - 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
|
|
1047
|
-
* - Auto provisioning
|
|
1048
|
-
* - Auto provisioning is a free feature
|
|
1049
|
-
* -
|
|
1046
|
+
* - 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).
|
|
1047
|
+
* - 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.
|
|
1048
|
+
* - 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).
|
|
1049
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
1050
1050
|
*
|
|
1051
1051
|
* @param tmpReq - CreateAutoProvisioningGroupRequest
|
|
1052
1052
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -1054,13 +1054,13 @@ export default class Client extends OpenApi {
|
|
|
1054
1054
|
*/
|
|
1055
1055
|
createAutoProvisioningGroupWithOptions(tmpReq: $_model.CreateAutoProvisioningGroupRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateAutoProvisioningGroupResponse>;
|
|
1056
1056
|
/**
|
|
1057
|
-
*
|
|
1057
|
+
* Creates an auto provisioning group.
|
|
1058
1058
|
*
|
|
1059
1059
|
* @remarks
|
|
1060
|
-
* - 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
|
|
1061
|
-
* - Auto provisioning
|
|
1062
|
-
* - Auto provisioning is a free feature
|
|
1063
|
-
* -
|
|
1060
|
+
* - 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).
|
|
1061
|
+
* - 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.
|
|
1062
|
+
* - 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).
|
|
1063
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
1064
1064
|
*
|
|
1065
1065
|
* @param request - CreateAutoProvisioningGroupRequest
|
|
1066
1066
|
* @returns CreateAutoProvisioningGroupResponse
|
|
@@ -1353,26 +1353,25 @@ export default class Client extends OpenApi {
|
|
|
1353
1353
|
*/
|
|
1354
1354
|
createHpcCluster(request: $_model.CreateHpcClusterRequest): Promise<$_model.CreateHpcClusterResponse>;
|
|
1355
1355
|
/**
|
|
1356
|
-
*
|
|
1356
|
+
* 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).
|
|
1357
1357
|
*
|
|
1358
1358
|
* @remarks
|
|
1359
|
-
* ###
|
|
1360
|
-
* - This
|
|
1361
|
-
* -
|
|
1362
|
-
* -
|
|
1363
|
-
*
|
|
1359
|
+
* ### Before you begin
|
|
1360
|
+
* - 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).
|
|
1361
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
1362
|
+
* - 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).
|
|
1363
|
+
* 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.
|
|
1364
1364
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
1365
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
1366
|
-
* -
|
|
1367
|
-
* >Notice:
|
|
1368
|
-
*
|
|
1369
|
-
*
|
|
1370
|
-
*
|
|
1371
|
-
*
|
|
1372
|
-
*
|
|
1373
|
-
*
|
|
1374
|
-
*
|
|
1375
|
-
* > 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.
|
|
1365
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
1366
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
1367
|
+
* >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.
|
|
1368
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
1369
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
1370
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
1371
|
+
* - Only one system disk snapshot can be specified.
|
|
1372
|
+
* - 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.
|
|
1373
|
+
*
|
|
1374
|
+
* > 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.
|
|
1376
1375
|
*
|
|
1377
1376
|
* @param request - CreateImageRequest
|
|
1378
1377
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -1380,26 +1379,25 @@ export default class Client extends OpenApi {
|
|
|
1380
1379
|
*/
|
|
1381
1380
|
createImageWithOptions(request: $_model.CreateImageRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateImageResponse>;
|
|
1382
1381
|
/**
|
|
1383
|
-
*
|
|
1382
|
+
* 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).
|
|
1384
1383
|
*
|
|
1385
1384
|
* @remarks
|
|
1386
|
-
* ###
|
|
1387
|
-
* - This
|
|
1388
|
-
* -
|
|
1389
|
-
* -
|
|
1390
|
-
*
|
|
1385
|
+
* ### Before you begin
|
|
1386
|
+
* - 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).
|
|
1387
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
1388
|
+
* - 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).
|
|
1389
|
+
* 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.
|
|
1391
1390
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
1392
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
1393
|
-
* -
|
|
1394
|
-
* >Notice:
|
|
1395
|
-
*
|
|
1396
|
-
*
|
|
1397
|
-
*
|
|
1398
|
-
*
|
|
1399
|
-
*
|
|
1400
|
-
*
|
|
1401
|
-
*
|
|
1402
|
-
* > 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.
|
|
1391
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
1392
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
1393
|
+
* >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.
|
|
1394
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
1395
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
1396
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
1397
|
+
* - Only one system disk snapshot can be specified.
|
|
1398
|
+
* - 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.
|
|
1399
|
+
*
|
|
1400
|
+
* > 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.
|
|
1403
1401
|
*
|
|
1404
1402
|
* @param request - CreateImageRequest
|
|
1405
1403
|
* @returns CreateImageResponse
|
|
@@ -1562,15 +1560,15 @@ export default class Client extends OpenApi {
|
|
|
1562
1560
|
*/
|
|
1563
1561
|
createKeyPair(request: $_model.CreateKeyPairRequest): Promise<$_model.CreateKeyPairResponse>;
|
|
1564
1562
|
/**
|
|
1565
|
-
*
|
|
1563
|
+
* 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.
|
|
1566
1564
|
*
|
|
1567
1565
|
* @remarks
|
|
1568
|
-
* After you
|
|
1569
|
-
* A launch template version
|
|
1570
|
-
* When
|
|
1571
|
-
* -
|
|
1572
|
-
* -
|
|
1573
|
-
* -
|
|
1566
|
+
* 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.
|
|
1567
|
+
* 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.
|
|
1568
|
+
* When you call this operation, take note of the following items:
|
|
1569
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
1570
|
+
* - 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.
|
|
1571
|
+
* - 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`.
|
|
1574
1572
|
*
|
|
1575
1573
|
* @param request - CreateLaunchTemplateRequest
|
|
1576
1574
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -1578,15 +1576,15 @@ export default class Client extends OpenApi {
|
|
|
1578
1576
|
*/
|
|
1579
1577
|
createLaunchTemplateWithOptions(request: $_model.CreateLaunchTemplateRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateLaunchTemplateResponse>;
|
|
1580
1578
|
/**
|
|
1581
|
-
*
|
|
1579
|
+
* 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.
|
|
1582
1580
|
*
|
|
1583
1581
|
* @remarks
|
|
1584
|
-
* After you
|
|
1585
|
-
* A launch template version
|
|
1586
|
-
* When
|
|
1587
|
-
* -
|
|
1588
|
-
* -
|
|
1589
|
-
* -
|
|
1582
|
+
* 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.
|
|
1583
|
+
* 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.
|
|
1584
|
+
* When you call this operation, take note of the following items:
|
|
1585
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
1586
|
+
* - 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.
|
|
1587
|
+
* - 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`.
|
|
1590
1588
|
*
|
|
1591
1589
|
* @param request - CreateLaunchTemplateRequest
|
|
1592
1590
|
* @returns CreateLaunchTemplateResponse
|
|
@@ -3995,13 +3993,13 @@ export default class Client extends OpenApi {
|
|
|
3995
3993
|
*/
|
|
3996
3994
|
describeImageSupportInstanceTypes(request: $_model.DescribeImageSupportInstanceTypesRequest): Promise<$_model.DescribeImageSupportInstanceTypesResponse>;
|
|
3997
3995
|
/**
|
|
3998
|
-
*
|
|
3996
|
+
* Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
|
|
3999
3997
|
*
|
|
4000
3998
|
* @remarks
|
|
4001
|
-
* -
|
|
4002
|
-
* -
|
|
4003
|
-
* - When
|
|
4004
|
-
* - When
|
|
3999
|
+
* - 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.
|
|
4000
|
+
* - 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.
|
|
4001
|
+
* - 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).
|
|
4002
|
+
* - 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).
|
|
4005
4003
|
*
|
|
4006
4004
|
* @param request - DescribeImagesRequest
|
|
4007
4005
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4009,13 +4007,13 @@ export default class Client extends OpenApi {
|
|
|
4009
4007
|
*/
|
|
4010
4008
|
describeImagesWithOptions(request: $_model.DescribeImagesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeImagesResponse>;
|
|
4011
4009
|
/**
|
|
4012
|
-
*
|
|
4010
|
+
* Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
|
|
4013
4011
|
*
|
|
4014
4012
|
* @remarks
|
|
4015
|
-
* -
|
|
4016
|
-
* -
|
|
4017
|
-
* - When
|
|
4018
|
-
* - When
|
|
4013
|
+
* - 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.
|
|
4014
|
+
* - 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.
|
|
4015
|
+
* - 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).
|
|
4016
|
+
* - 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).
|
|
4019
4017
|
*
|
|
4020
4018
|
* @param request - DescribeImagesRequest
|
|
4021
4019
|
* @returns DescribeImagesResponse
|
|
@@ -4895,7 +4893,7 @@ export default class Client extends OpenApi {
|
|
|
4895
4893
|
*/
|
|
4896
4894
|
describePrice(request: $_model.DescribePriceRequest): Promise<$_model.DescribePriceResponse>;
|
|
4897
4895
|
/**
|
|
4898
|
-
*
|
|
4896
|
+
* (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.
|
|
4899
4897
|
*
|
|
4900
4898
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
4901
4899
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4903,7 +4901,7 @@ export default class Client extends OpenApi {
|
|
|
4903
4901
|
*/
|
|
4904
4902
|
describeRecommendInstanceTypeWithOptions(request: $_model.DescribeRecommendInstanceTypeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeRecommendInstanceTypeResponse>;
|
|
4905
4903
|
/**
|
|
4906
|
-
*
|
|
4904
|
+
* (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.
|
|
4907
4905
|
*
|
|
4908
4906
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
4909
4907
|
* @returns DescribeRecommendInstanceTypeResponse
|