Import an image
Updated at：2025-10-20
This API is designed to import a single custom image.
Request structure
Plain Text
1POST /v{version}/image/import HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| osName | String | Yes | Request Body parameters | OS name |
| osArch | String | Yes | Request Body parameters | OS bitness |
| osType | String | Yes | Request Body parameters | OS type |
| osVersion | String | Yes | Request Body parameters | OS version |
| name | String | Yes | Request Body parameters | The image name can include uppercase and lowercase letters, numbers, Chinese characters, and -_/special characters. It must start with a letter and have a length of 1 to 65 characters. |
| bosUrl | String | Yes | Request Body parameters | BOS image address |
| detection | bolean | No | RequestBody | Image detection: If this parameter is not set, no detection will be triggered. If set to true, image detection will be automatically performed after importing. If set to false, no detection will occur. The default value is false. |
| generationType | String | No | Request Body parameters | Whether the imported image is applicable to BCC or EBC. Enumeration values: BCC, EBC. Default: BCC |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| Id | String | Returned image ID |
Request example
Plain Text
1POST /v2/image/import HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Date: Wed, 01 Mar 2006 12:00:00 GMT
5Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
6
7{
8 "osName":"Centos",
9 "osArch":"32",
10 "osType":"linux",
11 "osVersion":"6.5",
12 "name":"szth-onlineA_34_test",
13 "bosUrl":"http://cloud.baidu.com/t34"
14}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
6
7{
8 "id":"m-cxFNBt46"
9}