创建镜像缓存
更新时间: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
头部中的访问令牌是有效的。