调用 ModifyTemplateDefaultVersion 接口修改实例启动模板的默认版本。
使用模板启动实例时将自动使用默认版本,建议您将实例启动模板的常用版本设置为默认版本,避免手动选择版本的重复性工作。
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyTemplateDefaultVersion | 要执行的操作,取值:ModifyTemplateDefaultVersion |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
DefaultVersionNumber | Integer | 是 | 2 | 设置为默认版本的启动模板版本号。 |
LaunchTemplateId | String | 否 | lt-ysxc16auaugh9zfy**** | 实例启动模板ID。 说明 您必须指定 |
LaunchTemplateName | String | 否 | templateNameDemo | 实例启动模板名称。 说明 您必须指定 |
操作接口仅返回公共参数及错误码。
GET /?Action=ModifyTemplateDefaultVersion&Version=2020-04-01&LaunchTemplateId=lt-ysxc16auaugh9zfy****&DefaultVersionNumber=2 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: ecs
{ "ResponseMetadata": { "RequestId": "20220419160338010225133143077B****", "Action": "ModifyTemplateDefaultVersion", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": {} }
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter.AccountId | The required parameter AccountId is not supplied. | 账户ID不能为空。 |
400 | MissingParameter.LaunchTemplateNameAndLaunchTemplateId | The required parameter LaunchTemplateName and LaunchTemplateId is not supplied. | 模版名称和模版ID不允许同时为空。 |
404 | InvalidLaunchTemplate.NotFound | The specified LaunchTemplate does not exist. | 指定的启动模板不存在。 |
404 | InvalidTemplateVersion.NotFound | The specified TemplateVersion does not exist. | 指定的模板版本不存在。 |
400 | MissingParameter.DefaultVersionNumber | The required parameter DefaultVersionNumber is not supplied. | 修改启动模版默认版本的版本号不能为空。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |