创建镜像缓存
更新时间：2024-10-09
接口描述
此接口用于创建一个BCI镜像缓存，配置包括临时存储大小、自动匹配镜像缓存、原始镜像信息、子网 ID、安全组 ID、弹性公网 IP、镜像缓存名称、区域名称、是否需要弹性公网 IP 以及镜像仓库凭据。
请求结构
POST /v{version}/imageCache HTTP/1.1
Host: bci.bj.baidubce.com
Authorization: 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> | 否 | 镜像仓库凭据，每个对象包含服务器地址、用户名和密码 |
请求示例
POST /v2/imageCache
Content-Type: application/json
Authorization: Bearer <YOUR_ACCESS_TOKEN>
{
"temporaryStorageSize": 20,
"autoMatchImageCache": true,
"originImages": [
{
"originImageAddress": "dasda",
"originImageVersion": "dada"
}
],
"subnetId": "sbn-xxx",
"securityGroupId": "g-yyy",
"eipIp": "10.10.10.10",
"imageCacheName": "dasda",
"zoneName": "zoneB",
"needEip": false,
"imageRegistrySecrets": [
{
"server": "http://dsada",
"userName": "dasdd",
"password": "dasdad"
}
]
}响应示例
成功响应
- HTTP 状态码：
200 OK - Body：
{
"imageCacheId": "xxxxx"
}错误响应
- HTTP 状态码：
400 Bad Request - Body：
{
"code": "Invalid parameters",
"message": "One or more parameters are missing or invalid."
}或
- HTTP 状态码：
401 Unauthorized - Body：
{
"code": "Unauthorized",
"message": "You are not authorized to create resources."
}注意事项
- 确保请求体中的所有必须字段都有值，且数据类型正确。
- 如果
needEip设置为true，则eipIp字段必须提供。 - 确保
Authorization头部中的访问令牌是有效的。