调用ModifyLaunchTemplateDefaultVersion接口,并通过指定DefaultVersionNumber参数,切换启动模板的默认版本。如果您在创建实例(RunInstances)时不指定模板版本号,则会采用默认版本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecs:ModifyLaunchTemplateDefaultVersion |
update |
LaunchTemplate
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
模板所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| LaunchTemplateId |
string |
否 |
启动模板 ID。您必须指定 LaunchTemplateId 或 LaunchTemplateName 以确定模板。 |
lt-s-bp177juajht6**** |
| LaunchTemplateName |
string |
否 |
启动模板名称。您必须指定 LaunchTemplateId 或 LaunchTemplateName 以确定模板。 |
testLaunchTemplateName |
| DefaultVersionNumber |
integer |
是 |
设置为默认版本的启动模板版本号。 |
2 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| LaunchTemplateId |
string |
启动模板 ID。更多信息,请参见 DescribeLaunchTemplates 。 |
lt-bp1apo0bbbkuy0rj**** |
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidRegion.NotExist | %s | 指定的地域不存在,请确认参数是否正确。 |
| 400 | MissingParameter | %s | 缺失参数,请检查参数是否完整。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 403 | InnerServiceFailed | %s | 内部服务调用失败。 |
| 404 | InvalidLaunchTemplate.NotFound | %s | 没有找到指定的启动模版,请检查参数是否正确。 |
| 404 | InvalidLaunchTemplateVersion.NotFound | %s | 没有找到该版本的启动模版,请检查参数是否正确。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。