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

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

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

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

要查看生命周期策略的示例,请参阅Amazon ECR 中的生命周期策略的示例。有关使用创建生命周期策略的说明 AWS CLI,请参阅创建生命周期策略 (AWS 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