创建镜像缓存
更新时间:2024-10-09
接口描述
此接口用于创建一个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头部中的访问令牌是有效的。 
