Reinstall an instance
Updated at：2025-10-20
This API allows batch OS reinstallation for multiple BCC instances.
- After reinstallation, any snapshots based on the original system disk will be automatically deleted, but custom images based on the original system disk will be retained.
- EBC instances cannot be reinstalled when they are in a stopped state.
Request structure
Plain Text
1PUT /v{version}/instance/rebuild HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "instanceIds": [
7 "instanceId"
8 ],
9 "imageId": imageId,
10 "adminPass":"adminPass"
11}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| instanceIds | List |
Yes | RequestBody | The list of specified instance IDs, maximum 100 |
| imageId | String | Yes | RequestBody | Image ID to be specified |
| adminPass | String | No | RequestBody | Machine password. The password must be encrypted for transmission. See [Password Encryption Transmission Specification](BCC/API Reference/General Description.md#Password encryption transmission specification) for details. Either the adminPass or keypairId parameter must be specified |
| keypairId | String | No | RequestBody | Key pair ID to be bound to the instance being reinstalled. Either the adminPass or keypairId parameter must be specified |
| userData | String | No | RequestBody | Custom script |
| useLastUserData | boolean | No | RequestBody | Whether to use the current custom script. The default is false |
| isOpenHostEye | boolean | No | RequestBody | Whether to enable host security. The default is false |
| sysRootSize | int | No | RequestBody | Applicable only to EBC instances. System disk size is valid only for EBC instances. |
| isPreserveData | boolean | No | RequestBody | Applicable only to the local disk of EBC instances. Whether to retain data during reinstallation. If set to true, the raidId and sysRootSize fields will not be applied. |
| raidId | String | No | RequestBody | Applicable only to EBC instances. RAID configuration ID. This parameter is required if isPreserveData is set to false but does not apply when isPreserveData is set to true. |
| dataPartitionType | String | No | RequestBody | Applicable only to EBC instances. Data disk partitioning format. |
| rootPartitionType | String | No | RequestBody | Applicable only to EBC instances. System disk partitioning format. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
There are no special response parameters
Error codes
| Error code | Error description | HTTP status code | Chinese explanation |
|---|---|---|---|
| Instance.InsufficientRootDiskSize | Not enough root disk size. | 400 | The image used is too large, and the system disk size is insufficient |
Request example
Plain Text
1PUT /v2/instance/rebuild HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "instanceIds": [
8 "i-syGfPUYO",
9 "i-2EzRRGDx"
10 ]
11 "imageId": "m-mRjO3cjs",
12 "adminPass":"1qaz@WSX"
13}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS