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

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

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

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

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

规则优先级

rulePriority

类型:整数

必需:是

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

描述

description

类型:字符串

必需:否

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

标签状态

tagStatus

类型:字符串

必需:是

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

标签模式列表

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 以指定所有这些标签。如果指定多个标签,则仅选择具有所有指定标签的镜像。

存储类

storageClass

类型:字符串

必填项:是,如果countTypesinceImageTransitioned

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

计数类型

countType

类型:字符串

必需:是

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

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

计数单位

countUnit

类型:字符串

必填项:是,仅countType当设置为sinceImagePushedsinceImagePulled、或时 sinceImageTransitioned

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

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

计数

countNumber

类型:整数

必需:是

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

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

操作

type

类型:字符串。

必需:是

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

targetStorageClass

类型:字符串

必填项:是,如果typetransition

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