重装实例（批量重装）

更新时间：2025-03-27

该接口用于批量多个BCC实例重装操作系统。

实例重装后，基于原系统盘的快照会自动删除，基于原系统盘的自定义镜像会保留。
EBC实例在已关机状态下不支持重装。

请求结构

PUT /v{version}/instance/rebuild HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

{
    "instanceIds": [
        "instanceId"
    ],
    "imageId": imageId,
    "adminPass":"adminPass"
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
instanceIds	List<String>	是	RequestBody参数	指定的实例ID列表，最多100个
imageId	String	是	RequestBody参数	待指定的镜像ID
adminPass	String	否	RequestBody参数	机器密码，密码需要加密传输，详见密码加密传输规范，必须传递adminPass、keypairId其中一个参数
keypairId	String	否	RequestBody参数	待重装实例所要绑定的密钥对ID，必须传递adminPass、keypairId其中一个参数
userData	String	否	RequestBody参数	自定义脚本
useLastUserData	boolean	否	RequestBody参数	是否使用当前自定义脚本，默认true
isOpenHostEye	boolean	否	RequestBody参数	是否开启主机安全，默认true
sysRootSize	int	否	RequestBody参数	仅对ebc实例生效。系统盘大小，仅对ebc实例生效
isPreserveData	boolean	否	RequestBody参数	仅对ebc实例本地盘生效。是否保留数据重装。当值为true时，raidId和sysRootSize字段不生效
raidId	String	否	RequestBody参数	仅对ebc实例生效。raid配置Id，此参数在isPreserveData为false时为必填，在isPreserveData为true时不生效
dataPartitionType	String	否	RequestBody参数	仅对ebc实例生效。数据盘分区格式
rootPartitionType	String	否	RequestBody参数	仅对ebc实例生效。系统盘分区格式

返回头域

除公共头域，无其它特殊头域。

返回参数

无特殊返回参数

错误码

错误码	错误描述	HTTP状态码	中文解释
Instance.InsufficientRootDiskSize	Not enough root disk size.	400	使用镜像过大，系统盘大小不够

请求示例

PUT /v2/instance/rebuild HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "instanceIds": [
        "i-syGfPUYO",
        "i-2EzRRGDx"
    ]
    "imageId": "m-mRjO3cjs",
    "adminPass":"1qaz@WSX"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

重装实例

将实例加入安全组

云服务器 BCC

云服务器 BCC

重装实例（批量重装）