CreateImageCache
创建一个镜像缓存,以便后续创建ECI实例可以加速镜像拉取,减少实例启动耗时
服务地址:
华东1 金融云
输入参数
只看必填
RegionId地域ID
ZoneId可用区
SecurityGroupId安全组ID
VSwitchId交换机ID
ImageCacheName镜像缓存名称
EipInstanceId弹性公网IP
ResourceGroupId资源组ID
ImageCacheSize镜像缓存的大小
RetentionDays镜像缓存保留时间
AutoMatchImageCache是否开启镜像缓存复用
请选择布尔值
ImageRegistryCredential镜像仓库信息
0镜像仓库信息
Password镜像仓库密码
Server不带 http:// 或 https...
UserName镜像仓库用户名
Image用于制作镜像缓存的容器镜像
0用于制作镜像缓存的容器镜像
Tag镜像缓存标签信息
0镜像缓存标签信息
Key镜像缓存标签键
Value镜像缓存标签值
Flash是否开启极速镜像缓存功能
请选择布尔值
AcrRegistryInfoACR实例信息
0ACR实例信息
DomainACR企业版实例的域名
0ACR企业版实例的域名
InstanceNameACR企业版实例的名称
InstanceIdACR企业版实例ID
RegionIdACR企业版实例所属地域
ArnServiceECI实例等资源归属账号下的RAM角色...
ArnUserACR实例归属账号下的RAM角色的ARN
Annotations注解
PlainHttpRegistry自建镜像仓库地址
InsecureRegistry自建镜像仓库地址
StandardCopyCount标准快照副本数
FlashCopyCount本地快照副本数
EliminationStrategy镜像缓存的淘汰策略
OsType容器镜像的操作系统
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

注意事项

  • 创建镜像缓存涉及资源计费。建议您提前了解相关计费信息。更多信息,请参见镜像缓存计费
  • 创建镜像缓存前,您需要评估待缓存镜像的总大小,如果镜像总大小超过设置的缓存大小,将会创建失败。
  • 创建镜像缓存时,系统将自动创建一个 ECI 实例和一块 ESSD PL1 类型的云盘用于中转创建镜像缓存。创建过程中请勿删除 ECI 实例和云盘,否则镜像缓存将创建失败。
  • 创建镜像缓存将生成对应的快照。请勿删除快照,否则镜像缓存将会失效。
  • 如果使用 SDK,则对应版本为:Java 1.0.10 以上,Python 1.0.7 以上。

使用建议

  • 对于使用自定义域名的 ACR 企业版镜像,需要指定 ACR 实例(设置 AcrRegistryInfo 相关参数)来配置免密。设置 AcrRegistryInfo 相关参数时,必须设置 AcrRegistryInfo.N.InstanceId。
  • 如果该镜像缓存将用于批量创建多个(超过 1000 个)ECI 实例,建议您设置 StandardCopyCount 和 FlashCopyCount 实现快照多副本功能。快照多副本按增量数据收费,由于本次创建的多个快照副本数据均一致,因此使用快照多副本功能不会增加额外费用。
说明 调用 CreateImageCache 创建镜像缓存时,系统将自动为您创建一个服务关联角色 AliyunServiceRoleForECI,用于访问 ECS、VPC 等相关云服务。更多信息,请参见弹性容器实例服务关联角色

请求参数

字段名称字段详情
RegionIdstring

地域 ID。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
ZoneIdstring

可用区。

示例值:cn-hangzhou-g
SecurityGroupIdstring

安全组 ID。

示例值:sg-uf66jeqopgqa9hdn****参考取值来源:
    DescribeContainerGroups
VSwitchIdstring

交换机 ID。支持指定多个交换机 ID(单次最多 10 个),各交换机 ID 之间可以用半角逗号(,)进行分割,例如vsw-***,vsw-***

示例值:vsw-uf6h3rbwbm90urjwa****
ImageCacheNamestring

镜像缓存名称。

示例值:testcache参考取值来源:
    DescribeImageCaches
EipInstanceIdstring

弹性公网 IP。如果需要拉取公网镜像,需要确保 ECI 实例能够访问公网,您可以配置 EIP 或者 NAT 网关实现公网访问。

示例值:eip-2zedsm5mfl3uhdj2d****
ResourceGroupIdstring

资源组 ID。

示例值:rg-aekzh43v*****参考取值来源:
    DescribeContainerGroups
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性

示例值:123e4567-xxx-xxx-xxxx-42665544xxxx
ImageCacheSizeinteger<int32>

镜像缓存的大小。默认为 20 GiB。

示例值:20
RetentionDaysinteger<int32>

镜像缓存保留时间,过期将会被清理,默认永不过期。展开详情

示例值:7
AutoMatchImageCacheboolean

是否开启镜像缓存复用。开启后,新创建的镜像缓存可以复用已有镜像缓存的镜像层,加快镜像缓存的制作速度。取值范围:展开详情

示例值:true
ImageRegistryCredentialarray<object>

镜像仓库信息。

子级条数 <= 11
Imagearray<string>

用于制作镜像缓存的容器镜像。

示例值:registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl子级条数 <= 101
Tagarray<object>

镜像缓存标签信息,最多 20 个。

子级条数 <= 21
Flashboolean

是否开启极速镜像缓存功能,开启后,可以加速镜像缓存创建。取值范围:展开详情

示例值:true
AcrRegistryInfoarray<object>

ACR 实例信息。更多信息,请参见免密拉取 ACR 镜像

子级条数 <= 21
Annotationsstring

注解。该参数暂不对外使用。

示例值:hide
PlainHttpRegistrystring

自建镜像仓库地址。使用 HTTP 协议的自建镜像仓库中的镜像创建镜像缓存时,需配置该参数,使得 ECI 使用 HTTP 协议拉取镜像,避免因协议不同而导致镜像拉取失败。

示例值:"harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
InsecureRegistrystring

自建镜像仓库地址。展开详情

示例值:"harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
StandardCopyCountinteger<int32>

标准快照副本数。默认情况下,一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例,建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情

示例值:7
FlashCopyCountinteger<int32>

本地快照副本数。默认情况下,一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例,建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情

示例值:7
EliminationStrategystring

镜像缓存的淘汰策略。默认为空,表示一直保留。展开详情

示例值:LRU
OsTypestring

容器镜像的操作系统。取值范围:展开详情

示例值:Linux

返回参数

字段名称字段详情
RequestIdstring

请求 ID,唯一标识。

示例值:0E234675-3465-4CC3-9D0F-9A864BC391DD
ImageCacheIdstring

镜像缓存 ID。

示例值:imc-2zebxkiifuyzzlhl****
ContainerGroupIdstring

用于中转创建镜像缓存的 ECI 实例 ID。

示例值:eci-2zebxkiifuyzzlhl****
变更历史
暂无变更历史