本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Amazon ECR 中存档图片
## ECR 存档存储类别是什么？
Amazon ECR 档案存储类是一种新的存储类别，可为容器映像提供低成本、长期的存储。Amazon ECR 提供两种存储类别：
+ **ECR 标准存储类别** — 经常访问的活动图像的默认存储类别。
+ **ECR 存档存储类** — 一种低成本的存储类别，适用于很少访问但为了合规性或长期参考而需要保留的图像。与用于长期图像保留的标准存储类别相比，存档存储类别可以为大量图像节省成本。有关详细定价信息，请参阅 [Amazon ECR 定价](https://aws.amazon.com/ecr/pricing/)。
要存档图像，您有两个选择。首先，您可以配置生命周期规则，根据以下条件自动存档图像：
+ 自图片被推送以来的时间
+ 自上次拉取图片以来的时间
+ 存储库中的图像数量
您也可以将设置配置为在图像存档指定时间后将其永久删除。有关更多信息，请参阅[在 Amazon ECR 中使用生命周期策略自动清理映像](LifecyclePolicies.md)。
您也可以使用 Amazon ECR 控制台存档图像，或者 AWS CLI。有关更多信息，请参阅[存档图像](archive-image.md)。
当您需要再次使用存档图像时，可以将其恢复到 ECR 标准存储类别。您可以预计 ECR 会在 20 分钟内恢复映像。恢复的图像的行为与新推送的图像类似，恢复完成后可立即使用。恢复的图像受扫描、复制和存储库生命周期政策的约束。有关更多信息，请参阅[恢复镜像](restore-image.md)。
# 存档图像
您可以使用 Amazon ECR 控制台手动存档图像 AWS CLI，也可以使用生命周期策略自动存档图像。存档图像时：
+ 图像将移至存档存储类别。
+ 无法提取存档的图像。提取存档图像的请求将失败，并出现 404 错误。
+ 虽然无法拉取图像，但仍然可以使用** describe-images**命令对其进行描述，也可以使用**list-images**命令列出。图像状态将显示为`ARCHIVED`。
+ 存档图像的最短存储期限为 90 天。您不能配置生命周期策略来删除存档时间少于 90 天的图像。如果您必须删除存档时间少于 90 天的图片，则需要使用 **batch-delete-image** API，但您需要按照 90 天的最短存储时间付费。
+ 图像显示在存储库视图的 “**存档图像**” 选项卡中（仅当存储库中至少存档了一张图像时，该选项卡才会出现）。
+ 通过手动选择要还原的图像或将图像重新推送到存储库，可以将图像恢复为活动映像。
+ 如果存储库有生命周期策略，根据存档时间等标准删除图像，则该图像将被删除。
------
#### [ AWS 管理控制台 ]
**存档图像**
1. 在[https://console.aws.amazon.com/ecr/存储库](https://console.aws.amazon.com/ecr/repositories)中打开 Amazon ECR 控制台。
1. 在导航栏中，选择包含要存档图像的存储库的区域。
1. 在导航窗格中，选择**存储库**。
1. 在 “**存储库**” 页面上，选择包含要存档的图像的存储库。
1. 选择要存档的图像。您将看到图片详情。
1. 要存档图像，请选择 “**存档**” 按钮，并在出现提示时选择 “**确认**”。
1. 如果这是存储库中的第一张存档图像，则会出现一个新的**存档图像**选项卡，其中包含新存档的图像。如果还有其他存档的图像，则此图像将被添加到该选项卡中。
------
#### [ AWS CLI ]
**存档图像**
+ 使用**update-image-storage-class**命令通过将图像的存储类更新为`ARCHIVE`：
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class ARCHIVE
```
------
**使用生命周期策略存档图像**
+ 您可以使用生命周期策略为仓库配置存档规则，以自动存档图像。生命周期策略允许您根据以下条件自动存档图像：
+ 自图片被推送以来的时间
+ 自上次拉取图片以来的时间
+ 要保持活动状态的最大图像数
您还可以将生命周期策略配置为在图像存档指定时间后将其永久删除。有关包含存档操作的生命周期策略的更多信息和示例，请参阅[在 Amazon ECR 中使用生命周期策略自动清理映像](LifecyclePolicies.md)。
**注意**
存档图像的最短存储期限为 90 天。您不能配置生命周期策略来删除存档时间少于 90 天的图像。如果您必须删除存档时间少于 90 天的图片，则需要使用 **batch-delete-image** API，但您需要按照 90 天的最短存储时间付费。
使用**describe-images**命令描述图像时，存档图像`image-status`的值为`ARCHIVED`。您可以筛选图像`image-status`以仅查看存档图像或仅查看活动图像。
# 恢复镜像
恢复存档图像时，它会从 ECR 存档存储类移回 ECR 标准存储类别。恢复后的图像按标准存储费率收费。恢复过程执行的操作与创建新映像时发生的操作类似：
+ 恢复完成后，该映像便可供拉取。恢复通常需要 20 分钟，但完成速度可能更快。
+ 如果为存储库启用了推送时扫描，则将扫描已恢复的图像。请注意，图像存档之前的扫描结果将不可用。
+ 如果为存储库配置了复制，则如果在恢复时启用了复制，则还原的映像将被复制。
+ 恢复后的图像显示在现用图像列表中。
恢复映像通常需要 20 分钟，但完成时间可能更快。在还原过程中，映像仍处于存档状态，在恢复完成之前无法拉取。
------
#### [ AWS 管理控制台 ]
**恢复存档的图像**
1. 在[https://console.aws.amazon.com/ecr/存储库](https://console.aws.amazon.com/ecr/repositories)中打开 Amazon ECR 控制台。
1. 在导航栏中，选择包含要恢复的存档图像的存储库的区域。
1. 在导航窗格中，选择**存储库**。
1. 在 “**存储库**” 页面上，选择包含存档图像的存储库。
1. 选择存**档图像**选项卡。
1. 选择要恢复的存档图像。
1. 选择 “**恢复**” 并确认还原操作。
1. 等待恢复完成。恢复完成后，图像将出现在活动图像列表中。
------
#### [ AWS CLI ]
**恢复存档的图像**
+ 使用**update-image-storage-class**命令通过将存档图像的存储类更新为`STANDARD`：
```
aws ecr update-image-storage-class \
--repository-name my-repository \
--image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
--target-storage-class STANDARD
```
------
使用**describe-images**命令描述图像时，正在恢复的图像会有 o `image-status` f `ACTIVATING`。您可以使用值筛选图像`image-status``ACTIVATING`以查看当前正在恢复的图像。
恢复存档图像的另一种方法是将图像重新推送到存储库。当您推送当前已存档的图像时，该图像将立即恢复并从存档中删除。