创建镜像缓存
更新时间：2025-08-20
接口描述
此接口用于创建一个BCI镜像缓存，配置包括临时存储大小、自动匹配镜像缓存、原始镜像信息、子网 ID、安全组 ID、弹性公网 IP、镜像缓存名称、区域名称、是否需要弹性公网 IP 以及镜像仓库凭据。
请求结构
Plain Text
1POST /v{version}/imageCache HTTP/1.1
2Host: bci.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
请求体（Body）包含以下参数：
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
temporaryStorageSize |
Integer | 是 | 临时存储大小（单位：GB） |
autoMatchImageCache |
Boolean | 否 | 是否自动匹配镜像缓存 |
originImages |
List<OriginImage> | 是 | 原始镜像数组，每个对象包含镜像地址和版本信息 |
subnetId |
String | 是 | 子网 ID |
securityGroupId |
String | 是 | 安全组 ID |
eipIp |
String | 否 | 弹性公网 IP 地址 |
imageCacheName |
String | 是 | 镜像缓存名称 |
zoneName |
String | 是 | 区域名称 |
needEip |
Boolean | 是 | 是否需要弹性公网 IP |
imageRegistrySecrets |
List<ImageRegistryCredential> | 否 | 镜像仓库凭据，每个对象包含服务器地址、用户名和密码 |
请求示例
JSON
1POST /v2/imageCache
2Content-Type: application/json
3Authorization: Bearer <YOUR_ACCESS_TOKEN>
4
5{
6 "temporaryStorageSize": 20,
7 "autoMatchImageCache": true,
8 "originImages": [
9 {
10 "originImageAddress": "dasda",
11 "originImageVersion": "dada"
12 }
13 ],
14 "subnetId": "sbn-xxx",
15 "securityGroupId": "g-yyy",
16 "eipIp": "10.10.10.10",
17 "imageCacheName": "dasda",
18 "zoneName": "zoneB",
19 "needEip": false,
20 "imageRegistrySecrets": [
21 {
22 "server": "http://dsada",
23 "userName": "dasdd",
24 "password": "dasdad"
25 }
26 ]
27}响应示例
成功响应
- HTTP 状态码：
200 OK - Body：
JSON
1{
2 "imageCacheId": "xxxxx"
3}错误响应
- HTTP 状态码：
400 Bad Request - Body：
JSON
1{
2 "code": "Invalid parameters",
3 "message": "One or more parameters are missing or invalid."
4}或
- HTTP 状态码：
401 Unauthorized - Body：
JSON
1{
2 "code": "Unauthorized",
3 "message": "You are not authorized to create resources."
4}注意事项
- 确保请求体中的所有必须字段都有值，且数据类型正确。
- 如果
needEip设置为true，则eipIp字段必须提供。 - 确保
Authorization头部中的访问令牌是有效的。