ModifyLaunchTemplateDefaultVersion - 云服务器 ECS

调用ModifyLaunchTemplateDefaultVersion切换启动模板的某个版本为该模板的默认版本。如果您在创建实例（RunInstances）时不指定模板版本号，会采用默认版本。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyLaunchTemplateDefaultVersion	系统规定参数。取值：ModifyLaunchTemplateDefaultVersion。
RegionId	String	是	cn-hangzhou	模板所属的地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
LaunchTemplateId	String	否	lt-s-bp177juajht6****	启动模板ID。您必须指定LaunchTemplateId或LaunchTemplateName以确定模板。
LaunchTemplateName	String	否	testLaunchTemplateName	启动模板名称。您必须指定LaunchTemplateId或LaunchTemplateName以确定模板。
DefaultVersionNumber	Long	是	2	设置为默认版本的启动模板版本号。

返回数据

名称

类型

示例值

描述

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

LaunchTemplateId

String

lt-bp1apo0bbbkuy0rj****

启动模板ID。更多信息，请参见DescribeLaunchTemplates。

使用启动模板创建实例时，您必须指定LaunchTemplateId或LaunchTemplateName以确定启动模板。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyLaunchTemplateDefaultVersion
&DefaultVersionNumber=2
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-s-bp177juajht6****
&LaunchTemplateName=testLaunchTemplateName
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyLaunchTemplateDefaultVersionResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <LaunchTemplateId>lt-bp1apo0bbbkuy0rj****</LaunchTemplateId>
</ModifyLaunchTemplateDefaultVersionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "LaunchTemplateId" : "lt-bp1apo0bbbkuy0rj****"
}

错误码

HttpCode	错误码	错误信息	描述
400	InvalidRegion.NotExist	%s	指定的地域不存在，请确认参数是否正确。
400	MissingParameter	%s	缺失参数，请检查参数是否完整。
400	InvalidParameter	%s	无效的参数。
403	InnerServiceFailed	%s	内部服务调用失败。
404	InvalidLaunchTemplate.NotFound	%s	没有找到指定的启动模版，请检查参数是否正确。
404	InvalidLaunchTemplateVersion.NotFound	%s	没有找到该版本的启动模版，请检查参数是否正确。

访问错误中心查看更多错误码。