如何创建、查询、更新和删除镜像缓存_弹性容器实例-阿里云帮助中心

镜像缓存可以加速拉取镜像，减少ECI实例启动耗时。本文介绍如何创建、查询、更新和删除镜像缓存。

创建镜像缓存

您可以通过控制台或者openAPI手动创建镜像缓存。

说明

系统支持自动创建镜像缓存。在创建ECI实例时，如果开启了自动匹配镜像缓存，则在未匹配到镜像缓存的情况下，系统将自动创建镜像缓存。

您可以调用CreateImageCache接口来创建镜像缓存，主要参数说明如下表所示。更多信息，请参见CreateImageCache。

名称	类型	示例值	描述
RegionId	string	cn-hangzhou	地域ID。
ImageCacheName	string	testcache	镜像缓存名称。
Image.N	array	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl	用于制作镜像缓存的容器镜像。
SecurityGroupId	string	sg-uf66jeqopgqa9hdn****	安全组ID。
VSwitchId	string	vsw-uf6h3rbwbm90urjwa****	交换机ID。
ImageCacheSize	integer	20	镜像缓存大小。默认为20 GiB。
RetentionDays	integer	7	镜像缓存保留时长，过期将会被清理。单位为：天。
AutoMatchImageCache	boolean	false	是否开启镜像缓存复用。开启后，新创建的镜像缓存可以复用已有镜像缓存的镜像层，加快镜像缓存的制作速度。默认为false。
Flash	boolean	true	是否开启极速镜像缓存功能。开启后，可以加速镜像缓存创建。默认为false。

创建镜像缓存时，支持通过ACR企业版来免密拉取镜像，相关参数如下表所示。更多信息，请参见配置ACR企业版免密。

名称	类型	示例值	描述
AcrRegistryInfo.N.Domain.N	string	test****-registry.cn-beijing.cr.aliyuncs.com	ACR企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名，多个以半角逗号分隔。
AcrRegistryInfo.N.InstanceName	string	test****	ACR企业版实例的名称。
AcrRegistryInfo.N.InstanceId	string	cri-nwj395hgf6f3****	ACR企业版实例ID。
AcrRegistryInfo.N.RegionId	string	cn-beijing	ACR企业版实例所属地域。

在弹性容器实例控制台的镜像缓存页面，单击创建镜像缓存。
在弹出页面，配置相关参数。
选中服务协议，单击确认创建，并根据提示完成后续操作。
在镜像缓存页面查看创建结果。
状态列显示创建进度，当状态变为创建完成时，表示镜像缓存创建成功。单击镜像缓存ID，可以打开详情页面，查看基本信息和相关事件。

创建镜像缓存后，您可以查询镜像缓存信息。当镜像缓存状态为创建完成（Ready）时，可以使用该镜像缓存。

查询方式如下：

对于状态创建完成（Ready）或者UpdateFailed（更新失败）的镜像缓存，支持调用UpdateImageCache接口来更新镜像缓存，包括更新容器镜像、保留时长、镜像仓库信息等。更多信息，请参见UpdateImageCache。

镜像缓存对应一份快照，保留镜像缓存需要支付相应的快照费用。对于不再使用的镜像缓存，如果在创建时未设置保留时长，建议您及时手动删除。

说明

自动创建的镜像缓存快照由阿里云管理，如果在30天内未使用，将被自动删除。

删除方式如下：