创建一个镜像缓存。

使用说明

• 此接口为异步接口，当此接口返回成功时，会返回镜像缓存的 ID 信息，此时镜像缓存将进入{Creating, [Progressing]}状态，直到创建执行成功，进入{Ready, [Ok]}状态。请调用 ListImageCaches 接口获取该镜像缓存当前的状态，查看镜像缓存是否创建成功。
• 创建镜像缓存前，需要准备所需的容器镜像。支持使用火山引擎镜像仓库（CR）中的镜像，也支持使用第三方镜像仓库中的镜像。CR 中上传镜像的操作，请参见 推送和拉取镜像。
• 除了正在删除中的镜像缓存（状态为[Deleting,*]），每个火山引擎账号（含子用户）最多支持存在 20 个镜像缓存，超过后无法创建新的镜像缓存。您可以删除无用的镜像缓存，或 提交工单 申请提升配额。

请求说明

• 请求方式：POST
• 请求地址：https://open.volcengineapi.com/?Action=CreateImageCache&Version=2022-05-12

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 公共参数。

ImageRegistryCredentials

AutoPrewarmConfig

请求示例

POST /?Action= CreateImageCache&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
  "ImageCacheName": "test-imc",
  "SubnetIds": [
    "subnet-3rf6vwbgkg****", "subnet-2d6kpn09********", "subnet-3rfcnoa********"
  ],
  "SecurityGroupIds": [
    "sg-2byy13cnsczy****"
  ],
  "Images": [
"cr-cn-beijing.volces.com/vke****/nginx: latest", "cr-cn-beijing.volces.com/vke****/nginx:v1"
  ],
  "ImageRegistryCredentials": [{
      "UserName": "user_****@21000****",
      "Server": "cr-cn-beijing.volces.com",
      "Password": "dGhpcyBpcyBh********"
  }],
  "ImageCacheSize": 50
}

返回参数

本接口返回参数如下表所示，公共返回参数请参见 返回结果。

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023022020005173B********",
        "Action": "CreateImageCache",
        "Version": "2022-05-12",
        "Service": "vke",
        "Region": "cn-beijing"
    },
    "Result": {
        "ImageCacheId": "imc-3uqroqkx********"
    }

}

错误码

本接口错误码如下表所示，公共错误码请参见 公共错误码。