Amazon ECR 中的生命周期策略属性 - Amazon ECR
规则优先级描述标签状态标签模式列表标签前缀列表存储类计数类型计数单位计数 操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon ECR 中的生命周期策略属性

生命周期策略具有以下属性。

要查看生命周期策略的示例，请参阅Amazon ECR 中的生命周期策略的示例。有关使用创建生命周期策略的说明 Amazon CLI，请参阅创建生命周期策略 (Amazon CLI)。

规则优先级

rulePriority

类型：整数

必需：是

设置应用规则的顺序，从低到高。优先级为 1 的生命周期策略规则首先应用，优先级为 2 的规则下一个应用，依此类推。当您向某个生命周期策略添加规则时，必须为每个规则赋予一个唯一的 rulePriority 值。但是，在策略中的各规则之间，值不需要顺序。具有 tagStatus 值 any 的规则必须具有最大的 rulePriority 值并且最后被评估。

描述

description

类型：字符串

必需：否

(可选) 描述生命周期策略中规则的用途。

标签状态

tagStatus

类型：字符串

必需：是

确定要添加的生命周期策略规则是否为镜像指定标签。可接受的选项包括 tagged、untagged 或 any。如果您指定 any，则所有镜像都会根据它们评估规则。如果指定tagged，则还必须指定一个tagPrefixList或多个tagPatternList值。如果指定untagged，则必须同时省略tagPrefixList和。tagPatternList

标签模式列表

tagPatternList

类型：list[string]

必填项：tagStatus 设置为“已标记”且未指定 tagPrefixList 时，是必填项

为已标记的映像创建生命周期策略时，最佳实践是使用 tagPatternList 来指定要过期的标签。您必须指定以逗号分隔的可能包含通配符（*）的映像标签模式列表，以便根据此列表执行生命周期策略操作。例如，假设映像标记为 prod、prod1、prod2 等，则可以使用标签模式列表 prod* 来指定所有这些映像。如果指定多个标签，则仅选择具有所有指定标签的镜像。

重要

每个字符串最多可以使用四个通配符（*）。例如，["*test*1*2*3", "test*1*2*3*"] 有效，而 ["test*1*2*3*4*5*6"] 无效。

标签前缀列表

tagPrefixList

类型：list[string]

必填项：tagStatus 设置为“已标记”且未指定 tagPatternList 时，是必填项

仅在您指定了 "tagStatus": "tagged" 但未指定 tagPatternList 时才使用。您必须指定以逗号分隔的镜像标签前缀列表，以便根据此列表执行生命周期策略操作。例如，如果您的镜像被标记为 prod、prod1、prod2 等，则可以使用标签前缀 prod 以指定所有这些标签。如果指定多个标签，则仅选择具有所有指定标签的镜像。

存储类

storageClass

类型：字符串

必填项：是，如果countType是 sinceImageTransitioned

该规则将仅选择该存储类别的图像。使用imageCountMoreThan、或 o countType sinceImagePushed f 时sinceImagePulled，唯一支持的值是standard。使用计数类型时sinceImageTransitioned，这是必需的，唯一支持的值是archive。如果省略此项，则standard将使用的值。

计数类型

countType

类型：字符串

必需：是

指定要应用于镜像的计数类型。

如果 countType 设置为 imageCountMoreThan，您还可以指定 countNumber 以创建一个规则，用于设置存储库中存在的镜像数量限制。如果设置countType为sinceImagePushedsinceImagePulledsinceImageTransitioned、或，则还可以指定countUnit和countNumber来指定存储库中存在的图像的时间限制。

计数单位

countUnit

类型：字符串

必填项：是，仅countType当设置为sinceImagePushedsinceImagePulled、或时 sinceImageTransitioned

指定计数单位 days 作为时间单位，除此之外，还指定 countNumber 表示天数。

只有在 countType is sinceImagePushed sinceImagePulled、or 时才应指定此值sinceImageTransitioned；如果指定计数单位为任何其他值，countType则会出现错误。

计数

countNumber

类型：整数

必需：是

指定计数数量。可接受的值为正整数 (0 不是可接受的值)。

如果使用的 countType 是 imageCountMoreThan，则该值为您希望在存储库中保留的镜像的最大数量。如果使用的 countType 是 sinceImagePushed，则该值为镜像的最大使用期限。如果countType使用的是sinceImagePulled，则该值是自上次拉取图像以来的最大天数。如果countType使用的是sinceImageTransitioned，则该值为自图像存档以来的最大天数。

操作

type

类型：字符串。

必需：是

指定操作类型。支持的值为expire（删除图像）和transition（将图像移动到存档存储）。

targetStorageClass

类型：字符串

必填项：是，如果type是 transition

您希望生命周期策略将图像过渡到的存储类别。 archive是唯一支持的值。