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 值。值不必在策略中的规则之间保持顺序。具有 tagStatusany 的规则必须具有最大的 rulePriority 值并且最后被评估。

描述

description

类型:字符串

必需:否

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

标签状态

tagStatus

类型:字符串

必需:是

确定要添加的生命周期策略规则是否为镜像指定标签。可接受的选项包括 taggeduntaggedany。如果您指定 any,则所有镜像都会根据它们评估规则。如果指定 tagged,还必须指定 tagPrefixList 值。如果指定 untagged,那么必须省略 tagPrefixList

标签模式列表

tagPatternList

类型:list[string]

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

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

重要

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

标签前缀列表

tagPrefixList

类型:list[string]

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

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

计数类型

countType

类型:字符串

必需:是

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

如果 countType 设置为 imageCountMoreThan,您还可以指定 countNumber 以创建一个规则,用于设置存储库中存在的镜像数量限制。如果 countType 设置为 sinceImagePushed,您还可以指定 countUnitcountNumber,以指定存储库中存在的镜像的时间限制。

计数单位

countUnit

类型:字符串

必需:是,仅当 countType 设置为 sinceImagePushed

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

只有在 countTypesinceImagePushed 时才能指定;如果您在 countType 是任何其他值时指定计数单位,将发生错误。

计数

countNumber

类型:整数

必需:是

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

如果使用的 countTypeimageCountMoreThan,则该值为您希望在存储库中保留的镜像的最大数量。如果使用的 countTypesinceImagePushed,则该值为镜像的最大使用期限。

操作

type

类型:字符串。

必需:是

指定操作类型。支持的值为 expire