更新时间:2024-04-18 GMT+08:00
重装弹性云服务器操作系统(未安装Cloud-init)
功能介绍
重装弹性云服务器的操作系统。
本接口为异步接口,当前重装弹性云服务器操作系统请求下发成功后会返回job_id,此时重装弹性云服务器操作系统并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表云服务器操作系统重装成功。
调用该接口后,系统将卸载系统盘,然后使用原镜像重新创建系统盘,并挂载至弹性云服务器,实现重装操作系统功能。
该接口支持未安装Cloud-init或Cloudbase-init的镜像,如果镜像安装了Cloud-init或者Cloudbase-init,请使用 重装弹性云服务器操作系统(安装Cloud-init)接口。
接口约束
- 关机状态或者重装操作系统失败的弹性云服务器,才能执行重装操作。
- 不包含系统盘的弹性云服务器不能执行重装操作。
- 执行重装操作系统任务时,请勿并行执行其他任务,否则可能会引起重装操作系统失败。
URI
POST /v1/{project_id}/cloudservers/{server_id}/reinstallos
请求消息
请求参数如表2所示。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
adminpass |
否 |
String |
云服务器管理员账户的初始登录密码。 其中,Windows管理员账户的用户名为Administrator,Linux管理员账户的用户名为root。 建议密码复杂度如下:
说明:
|
keyname |
否 |
String |
密钥名称。 |
userid |
否 |
String |
用户ID。 |
响应消息
请参考响应(任务类)。
请求示例
重装云服务器操作系统,重装后采用密钥方式登录鉴权。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/reinstallos { "os-reinstall": { "keyname": "KeyPair-350b", "userid": "7e25b1da389f4697a79df3a0e5bd494e" } }
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题: 状态管理