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

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

创建镜像缓存

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

说明

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

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

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

说明

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

在弹性容器实例控制台的镜像缓存页面，单击创建镜像缓存。
在弹出页面，配置相关参数。
相关参数说明如下：
- 基本参数：设置地域、可用区、专有网络和安全组等参数，用于创建中转实例。
  重要
  如果镜像需要公网拉取，在专有网络没有配置NAT网关的情况下，请绑定弹性公网IP。
- 镜像缓存：输入镜像缓存名称，选择镜像地址和版本号，按需设置大小和保留时长。
- 镜像仓库访问凭证：如果镜像是私有镜像，请填写镜像仓库的地址、访问用户名和密码。
选中服务协议，单击确认创建，并根据提示完成后续操作。
在镜像缓存页面查看创建结果。
状态列显示创建进度，当状态变为创建完成时，表示镜像缓存创建成功。单击镜像缓存ID，可以打开详情页面，查看基本信息和相关事件。

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

查询方式如下：

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

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

说明

自动创建的镜像缓存由阿里云管理，在一定时长后会被自动删除。

删除方式如下：