interface LifecycleRule

Language	Type name
.NET	Amazon.CDK.AWS.ECR.LifecycleRule
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsecr#LifecycleRule
Java	software.amazon.awscdk.services.ecr.LifecycleRule
Python	aws_cdk.aws_ecr.LifecycleRule
TypeScript (source)	aws-cdk-lib » aws_ecr » LifecycleRule

An ECR life cycle rule.

Example

declare const repository: ecr.Repository;
repository.addLifecycleRule({ tagPrefixList: ['prod'], maxImageCount: 9999 });
repository.addLifecycleRule({ maxImageAge: Duration.days(30) });

Properties

Name	Type	Description
description?	string	Describes the purpose of the rule.
maxImageAge?	Duration	The maximum age of images to retain. The value must represent a number of days.
maxImageCount?	number	The maximum number of images to retain.
rulePriority?	number	Controls the order in which rules are evaluated (low to high).
tagPatternList?	string[]	Select images that have ALL the given patterns in their tag.
tagPrefixList?	string[]	Select images that have ALL the given prefixes in their tag.
tagStatus?	TagStatus	Select images based on tags.

---

description?

Type: string (optional, default: No description)

Describes the purpose of the rule.

---

maxImageAge?

Type: Duration (optional)

The maximum age of images to retain. The value must represent a number of days.

Specify exactly one of maxImageCount and maxImageAge.

---

maxImageCount?

Type: number (optional)

The maximum number of images to retain.

Specify exactly one of maxImageCount and maxImageAge.

---

rulePriority?

Type: number (optional, default: Automatically assigned)

Controls the order in which rules are evaluated (low to high).

All rules must have a unique priority, where lower numbers have higher precedence. The first rule that matches is applied to an image.

There can only be one rule with a tagStatus of Any, and it must have the highest rulePriority.

All rules without a specified priority will have incrementing priorities automatically assigned to them, higher than any rules that DO have priorities.

---

tagPatternList?

Type: string[] (optional)

Select images that have ALL the given patterns in their tag.

There is a maximum limit of four wildcards () per string. For example, ["test123", "test123"] is valid but ["test12345*6"] is invalid.

Both tagPrefixList and tagPatternList cannot be specified together in a rule.

Only if tagStatus == TagStatus.Tagged

---

tagPrefixList?

Type: string[] (optional)

Select images that have ALL the given prefixes in their tag.

Both tagPrefixList and tagPatternList cannot be specified together in a rule.

Only if tagStatus == TagStatus.Tagged

---

tagStatus?

Type: TagStatus (optional, default: TagStatus.Tagged if tagPrefixList or tagPatternList is given, TagStatus.Any otherwise)

Select images based on tags.

Only one rule is allowed to select untagged images, and it must have the highest rulePriority.