You can call this operation to modify the default version of an instance launch template. If you do not specify a template version number when you create an instance (RunInstances), the default version will be used.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
DefaultVersionNumber Long Yes 2

The default version number of the instance launch template.

RegionId String Yes cn-hangzhou

The ID of the region to which the instance launch template belongs. You can call the DescribeRegions operation to query the most recent region list.

Action String Yes ModifyLaunchTemplateDefaultVersion

The operation that you want to perform. Set the value to ModifyLaunchTemplateDefaultVersion.

LaunchTemplateId String No lt-templateid1

The ID of the instance launch template. You must specify the LaunchTemplateId parameter or the LaunchTemplateName parameter to determine an instance launch template.

LaunchTemplateName String No lt-name1

The name of the instance launch template. You must specify the LaunchTemplateId parameter or the LaunchTemplateName parameter to determine an instance launch template.

Response parameters

Parameter Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request. This parameter is returned regardless of whether the operation is successful.

Examples

Sample requests


https://ecs.aliyuncs.com/?Action=ModifyLaunchTemplateDefaultVersion
&DefaultVersionNumber=2
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-templateid1
&LaunchTemplateName=lt-name1
&<Common request parameters>

Sample success responses

XML format

<ModifyLaunchTemplateDefaultVersionResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
</ModifyLaunchTemplateDefaultVersionResponse>

JSON format

{
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidRegion.NotExist %s The error message returned because the specified region does not exist.
404 InvalidLaunchTemplate.NotFound %s The error message returned because the specified template name does not exist.
404 InvalidLaunchTemplateVersion.NotFound %s The error message returned because the specified template version does not exist.
400 MissingParameter %s The error message returned because a required parameter is not specified.
400 InvalidParameter %s The error message returned because the parameter format is invalid.
403 InnerServiceFailed %s The error message returned because an internal service failed to be called.

For a list of error codes, visit the API Error Center.