重装BEC虚机实例
更新时间：2023-06-15
接口描述
本接口用于重装BEC虚机实例。
请求结构
PUT /v2/vm/instance/{instanceId}?rebuild HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
X-Bce-Accesskey: accesskey
{
"adminPass": "",
"imageId": "",
"imageType": "",
"keypairId": "",
"resetDataDisk": true
}请求头域
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
|---|---|---|---|---|
| X-Bce-Accesskey | BEC加密接口返回的accessKeyId，用作虚机实例管理员密码解密。参考密码加密传输规范 | header | 否 | string |
请求参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
|---|---|---|---|---|
| instanceId | 虚机实例ID | path | 是 | string |
| rebuild | 表示重装，不用传值 | query | 是 | string |
| request | 重装虚机实例请求 | body | 是 | RebuildBecVmInstanceRequest |
| adminPass | 虚机密码限制长度为8～32位字符，英文、数字和符号必须同时存在， 符号仅限!@#$%^+*() keypairId和adminPass不能同时为空 |
否 | string | |
| imageId | 镜像ID（配合imageType使用） | 是 | string | |
| imageType | 镜像类型，取值为bec、bcc，分别表示为公共镜像或BEC自定义镜像、 BCC自定义镜像 |
是 | string | |
| keypairId | 实例所要绑定的密钥对ID。keypairId和adminPass不能同时为空 | 否 | string | |
| resetDataDisk | 重装是否需要重置数据盘。true：重置，false：不重置 | 否 | boolean | |
| clientToken | clientToken | query | 否 | string |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无
错误码
请参照错误返回章节的内容。
请求示例
PUT /v2/vm/instance/vm-4a3eoswh-1-m-hangzhou-rkwkb?rebuild HTTP/1.1
Host: bec.baidubce.com
X-Bce-Accesskey: accesskey
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"imageId": "m-O3eum4tp",
"imageType": "bec",
"adminPass": "adminPass"
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS