创建镜像缓存
更新时间：2026-09-09
- 创建一个BCI镜像缓存，用于加速容器镜像拉取。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/imageCache HTTP/1.1
2Host: bci.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "imageCacheName": imageCacheName,
7 "originImages": originImages,
8 "subnetId": subnetId,
9 "securityGroupId": securityGroupId,
10 "zoneName": zoneName,
11 "temporaryStorageSize": temporaryStorageSize,
12 "needEip": needEip
13}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为2 |
| imageCacheName | String | 是 | RequestBody参数 | 镜像缓存名称 |
| originImages | List<OriginImage> | 是 | RequestBody参数 | 原始镜像数组，每个对象包含镜像地址和版本信息 |
| subnetId | String | 是 | RequestBody参数 | 子网ID |
| securityGroupId | String | 是 | RequestBody参数 | 安全组ID |
| zoneName | String | 是 | RequestBody参数 | 可用区名称 |
| temporaryStorageSize | Integer | 是 | RequestBody参数 | 临时存储大小（单位：GB） |
| needEip | Boolean | 是 | RequestBody参数 | 是否需要弹性公网IP |
| eipIp | String | 否 | RequestBody参数 | 弹性公网IP地址，needEip为true时必须提供 |
| autoMatchImageCache | Boolean | 否 | RequestBody参数 | 是否自动匹配镜像缓存 |
| imageRegistrySecrets | List<ImageRegistryCredential> | 否 | RequestBody参数 | 镜像仓库凭据 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| imageCacheId | String | 镜像缓存ID |
请求示例
Plain Text
1POST /v2/imageCache HTTP/1.1
2Host: bci.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "temporaryStorageSize": 20,
8 "autoMatchImageCache": true,
9 "originImages": [
10 {
11 "originImageAddress": "registry.baidubce.com/cce-plugin-dev/nginx",
12 "originImageVersion": "v1"
13 }
14 ],
15 "subnetId": "sbn-y0ma0t2r0syf",
16 "securityGroupId": "g-mtg6mvb4vn75",
17 "imageCacheName": "my-image-cache",
18 "zoneName": "zoneC",
19 "needEip": false,
20 "imageRegistrySecrets": [
21 {
22 "server": "docker.io/myrepo",
23 "userName": "myuser",
24 "password": "mypassword"
25 }
26 ]
27}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Tue, 06 Sep 2016 10:08:44 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "imageCacheId": "ic-xxxxx"
8}评价此篇文章