@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.js
CHANGED
|
@@ -2234,29 +2234,29 @@ class Client extends openapi_core_1.default {
|
|
|
2234
2234
|
return await this.cancelTaskWithOptions(request, runtime);
|
|
2235
2235
|
}
|
|
2236
2236
|
/**
|
|
2237
|
-
*
|
|
2237
|
+
* Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
|
|
2238
2238
|
*
|
|
2239
2239
|
* @remarks
|
|
2240
|
-
* > The
|
|
2241
|
-
* ###
|
|
2242
|
-
* - This is an asynchronous operation. After a successful call,
|
|
2240
|
+
* > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
|
|
2241
|
+
* ### How to use
|
|
2242
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
|
|
2243
2243
|
* ### Features
|
|
2244
|
-
* -
|
|
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
|
-
* - A disk undergoing a
|
|
2258
|
-
* - A disk
|
|
2259
|
-
* -
|
|
2244
|
+
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
|
|
2245
|
+
* - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
|
|
2246
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
2247
|
+
* - You can specify the `new disk` type and performance level (PL) during cloning.
|
|
2248
|
+
* - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
2249
|
+
* - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
|
|
2250
|
+
* - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
|
|
2251
|
+
* - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
|
|
2252
|
+
* - The `new disk` created by cloning does not support reinitialization.
|
|
2253
|
+
* - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
|
|
2254
|
+
* - `Source disk` status restrictions:
|
|
2255
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2256
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2257
|
+
* - A disk undergoing a specification change cannot be used as the `source disk`.
|
|
2258
|
+
* - A disk undergoing expansion cannot be used as the `source disk`.
|
|
2259
|
+
* - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
|
|
2260
2260
|
*
|
|
2261
2261
|
* @param request - CloneDisksRequest
|
|
2262
2262
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2336,29 +2336,29 @@ class Client extends openapi_core_1.default {
|
|
|
2336
2336
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CloneDisksResponse({}));
|
|
2337
2337
|
}
|
|
2338
2338
|
/**
|
|
2339
|
-
*
|
|
2339
|
+
* Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
|
|
2340
2340
|
*
|
|
2341
2341
|
* @remarks
|
|
2342
|
-
* > The
|
|
2343
|
-
* ###
|
|
2344
|
-
* - This is an asynchronous operation. After a successful call,
|
|
2342
|
+
* > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
|
|
2343
|
+
* ### How to use
|
|
2344
|
+
* - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
|
|
2345
2345
|
* ### Features
|
|
2346
|
-
* -
|
|
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
|
-
* - A disk undergoing a
|
|
2360
|
-
* - A disk
|
|
2361
|
-
* -
|
|
2346
|
+
* - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
|
|
2347
|
+
* - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
|
|
2348
|
+
* - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
|
|
2349
|
+
* - You can specify the `new disk` type and performance level (PL) during cloning.
|
|
2350
|
+
* - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
|
|
2351
|
+
* - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
|
|
2352
|
+
* - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
|
|
2353
|
+
* - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
|
|
2354
|
+
* - The `new disk` created by cloning does not support reinitialization.
|
|
2355
|
+
* - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
|
|
2356
|
+
* - `Source disk` status restrictions:
|
|
2357
|
+
* - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
|
|
2358
|
+
* - The `source disk` status is "Available" and the disk has been previously attached.
|
|
2359
|
+
* - A disk undergoing a specification change cannot be used as the `source disk`.
|
|
2360
|
+
* - A disk undergoing expansion cannot be used as the `source disk`.
|
|
2361
|
+
* - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
|
|
2362
2362
|
*
|
|
2363
2363
|
* @param request - CloneDisksRequest
|
|
2364
2364
|
* @returns CloneDisksResponse
|
|
@@ -2805,13 +2805,13 @@ class Client extends openapi_core_1.default {
|
|
|
2805
2805
|
return await this.createActivationWithOptions(request, runtime);
|
|
2806
2806
|
}
|
|
2807
2807
|
/**
|
|
2808
|
-
*
|
|
2808
|
+
* Creates an auto provisioning group.
|
|
2809
2809
|
*
|
|
2810
2810
|
* @remarks
|
|
2811
|
-
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create
|
|
2812
|
-
* - Auto provisioning
|
|
2813
|
-
* - Auto provisioning is a free feature
|
|
2814
|
-
* -
|
|
2811
|
+
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
|
|
2812
|
+
* - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
|
|
2813
|
+
* - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
|
|
2814
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
2815
2815
|
*
|
|
2816
2816
|
* @param tmpReq - CreateAutoProvisioningGroupRequest
|
|
2817
2817
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -2953,13 +2953,13 @@ class Client extends openapi_core_1.default {
|
|
|
2953
2953
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoProvisioningGroupResponse({}));
|
|
2954
2954
|
}
|
|
2955
2955
|
/**
|
|
2956
|
-
*
|
|
2956
|
+
* Creates an auto provisioning group.
|
|
2957
2957
|
*
|
|
2958
2958
|
* @remarks
|
|
2959
|
-
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create
|
|
2960
|
-
* - Auto provisioning
|
|
2961
|
-
* - Auto provisioning is a free feature
|
|
2962
|
-
* -
|
|
2959
|
+
* - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
|
|
2960
|
+
* - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
|
|
2961
|
+
* - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
|
|
2962
|
+
* - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
|
|
2963
2963
|
*
|
|
2964
2964
|
* @param request - CreateAutoProvisioningGroupRequest
|
|
2965
2965
|
* @returns CreateAutoProvisioningGroupResponse
|
|
@@ -4009,26 +4009,25 @@ class Client extends openapi_core_1.default {
|
|
|
4009
4009
|
return await this.createHpcClusterWithOptions(request, runtime);
|
|
4010
4010
|
}
|
|
4011
4011
|
/**
|
|
4012
|
-
*
|
|
4012
|
+
* Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
|
|
4013
4013
|
*
|
|
4014
4014
|
* @remarks
|
|
4015
|
-
* ###
|
|
4016
|
-
* - This
|
|
4017
|
-
* -
|
|
4018
|
-
* -
|
|
4019
|
-
*
|
|
4015
|
+
* ### Before you begin
|
|
4016
|
+
* - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
|
|
4017
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
4018
|
+
* - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
|
|
4019
|
+
* The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
|
|
4020
4020
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
4021
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
4022
|
-
* -
|
|
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.
|
|
4021
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
4022
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
4023
|
+
* >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
|
|
4024
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
4025
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
4026
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
4027
|
+
* - Only one system disk snapshot can be specified.
|
|
4028
|
+
* - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
|
|
4029
|
+
*
|
|
4030
|
+
* > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
|
|
4032
4031
|
*
|
|
4033
4032
|
* @param request - CreateImageRequest
|
|
4034
4033
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4117,26 +4116,25 @@ class Client extends openapi_core_1.default {
|
|
|
4117
4116
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateImageResponse({}));
|
|
4118
4117
|
}
|
|
4119
4118
|
/**
|
|
4120
|
-
*
|
|
4119
|
+
* Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
|
|
4121
4120
|
*
|
|
4122
4121
|
* @remarks
|
|
4123
|
-
* ###
|
|
4124
|
-
* - This
|
|
4125
|
-
* -
|
|
4126
|
-
* -
|
|
4127
|
-
*
|
|
4122
|
+
* ### Before you begin
|
|
4123
|
+
* - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
|
|
4124
|
+
* - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
|
|
4125
|
+
* - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
|
|
4126
|
+
* The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
|
|
4128
4127
|
* - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
|
|
4129
|
-
* - The instance must be in the `Running` or `Stopped` state.
|
|
4130
|
-
* -
|
|
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.
|
|
4128
|
+
* - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
|
|
4129
|
+
* - After the operation is called, a new snapshot is created for each disk of the instance.
|
|
4130
|
+
* >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
|
|
4131
|
+
* - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
|
|
4132
|
+
* - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
|
|
4133
|
+
* - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
|
|
4134
|
+
* - Only one system disk snapshot can be specified.
|
|
4135
|
+
* - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
|
|
4136
|
+
*
|
|
4137
|
+
* > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
|
|
4140
4138
|
*
|
|
4141
4139
|
* @param request - CreateImageRequest
|
|
4142
4140
|
* @returns CreateImageResponse
|
|
@@ -4728,15 +4726,15 @@ class Client extends openapi_core_1.default {
|
|
|
4728
4726
|
return await this.createKeyPairWithOptions(request, runtime);
|
|
4729
4727
|
}
|
|
4730
4728
|
/**
|
|
4731
|
-
*
|
|
4729
|
+
* Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
|
|
4732
4730
|
*
|
|
4733
4731
|
* @remarks
|
|
4734
|
-
* After you
|
|
4735
|
-
* A launch template version
|
|
4736
|
-
* When
|
|
4737
|
-
* -
|
|
4738
|
-
* -
|
|
4739
|
-
* -
|
|
4732
|
+
* After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
|
|
4733
|
+
* A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
|
|
4734
|
+
* When you call this operation, take note of the following items:
|
|
4735
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
4736
|
+
* - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
|
|
4737
|
+
* - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
|
|
4740
4738
|
*
|
|
4741
4739
|
* @param request - CreateLaunchTemplateRequest
|
|
4742
4740
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -4930,15 +4928,15 @@ class Client extends openapi_core_1.default {
|
|
|
4930
4928
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLaunchTemplateResponse({}));
|
|
4931
4929
|
}
|
|
4932
4930
|
/**
|
|
4933
|
-
*
|
|
4931
|
+
* Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
|
|
4934
4932
|
*
|
|
4935
4933
|
* @remarks
|
|
4936
|
-
* After you
|
|
4937
|
-
* A launch template version
|
|
4938
|
-
* When
|
|
4939
|
-
* -
|
|
4940
|
-
* -
|
|
4941
|
-
* -
|
|
4934
|
+
* After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
|
|
4935
|
+
* A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
|
|
4936
|
+
* When you call this operation, take note of the following items:
|
|
4937
|
+
* - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
|
|
4938
|
+
* - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
|
|
4939
|
+
* - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
|
|
4942
4940
|
*
|
|
4943
4941
|
* @param request - CreateLaunchTemplateRequest
|
|
4944
4942
|
* @returns CreateLaunchTemplateResponse
|
|
@@ -12911,13 +12909,13 @@ class Client extends openapi_core_1.default {
|
|
|
12911
12909
|
return await this.describeImageSupportInstanceTypesWithOptions(request, runtime);
|
|
12912
12910
|
}
|
|
12913
12911
|
/**
|
|
12914
|
-
*
|
|
12912
|
+
* Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
|
|
12915
12913
|
*
|
|
12916
12914
|
* @remarks
|
|
12917
|
-
* -
|
|
12918
|
-
* -
|
|
12919
|
-
* - When
|
|
12920
|
-
* - When
|
|
12915
|
+
* - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
|
|
12916
|
+
* - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
|
|
12917
|
+
* - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
|
|
12918
|
+
* - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
|
|
12921
12919
|
*
|
|
12922
12920
|
* @param request - DescribeImagesRequest
|
|
12923
12921
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -13024,13 +13022,13 @@ class Client extends openapi_core_1.default {
|
|
|
13024
13022
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeImagesResponse({}));
|
|
13025
13023
|
}
|
|
13026
13024
|
/**
|
|
13027
|
-
*
|
|
13025
|
+
* Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
|
|
13028
13026
|
*
|
|
13029
13027
|
* @remarks
|
|
13030
|
-
* -
|
|
13031
|
-
* -
|
|
13032
|
-
* - When
|
|
13033
|
-
* - When
|
|
13028
|
+
* - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
|
|
13029
|
+
* - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
|
|
13030
|
+
* - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
|
|
13031
|
+
* - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
|
|
13034
13032
|
*
|
|
13035
13033
|
* @param request - DescribeImagesRequest
|
|
13036
13034
|
* @returns DescribeImagesResponse
|
|
@@ -16190,7 +16188,7 @@ class Client extends openapi_core_1.default {
|
|
|
16190
16188
|
return await this.describePriceWithOptions(request, runtime);
|
|
16191
16189
|
}
|
|
16192
16190
|
/**
|
|
16193
|
-
*
|
|
16191
|
+
* (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
|
|
16194
16192
|
*
|
|
16195
16193
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
16196
16194
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -16276,7 +16274,7 @@ class Client extends openapi_core_1.default {
|
|
|
16276
16274
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeRecommendInstanceTypeResponse({}));
|
|
16277
16275
|
}
|
|
16278
16276
|
/**
|
|
16279
|
-
*
|
|
16277
|
+
* (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
|
|
16280
16278
|
*
|
|
16281
16279
|
* @param request - DescribeRecommendInstanceTypeRequest
|
|
16282
16280
|
* @returns DescribeRecommendInstanceTypeResponse
|