software.amazon.awscdk.services.ecr

Interface LifecycleRule

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

LifecycleRule.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-05-19T23:09:24.517Z")
 @Stability(value=Stable)
public interface LifecycleRule
extends software.amazon.jsii.JsiiSerializable

An ECR life cycle rule.

Example:

 Repository repository;
 repository.addLifecycleRule(LifecycleRule.builder().tagPrefixList(List.of("prod")).maxImageCount(9999).build());
 repository.addLifecycleRule(LifecycleRule.builder().maxImageAge(Duration.days(30)).build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	LifecycleRule.Builder A builder for LifecycleRule
static class	LifecycleRule.Jsii$Proxy An implementation for LifecycleRule

Method Summary

Modifier and Type	Method and Description
static LifecycleRule.Builder	builder()
default String	getDescription() Describes the purpose of the rule.
default Duration	getMaxImageAge() The maximum age of images to retain.
default Number	getMaxImageCount() The maximum number of images to retain.
default Number	getRulePriority() Controls the order in which rules are evaluated (low to high).
default List<String>	getTagPrefixList() Select images that have ALL the given prefixes in their tag.
default TagStatus	getTagStatus() Select images based on tags.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getDescription

@Stability(value=Stable)
 @Nullable
default String getDescription()

Describes the purpose of the rule.

Default: No description

getMaxImageAge

@Stability(value=Stable)
 @Nullable
default Duration getMaxImageAge()

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

Specify exactly one of maxImageCount and maxImageAge.

getMaxImageCount

@Stability(value=Stable)
 @Nullable
default Number getMaxImageCount()

The maximum number of images to retain.

Specify exactly one of maxImageCount and maxImageAge.

getRulePriority

@Stability(value=Stable)
 @Nullable
default Number getRulePriority()

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.

Default: Automatically assigned

getTagPrefixList

@Stability(value=Stable)
 @Nullable
default List<String> getTagPrefixList()

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

Only if tagStatus == TagStatus.Tagged

getTagStatus

@Stability(value=Stable)
 @Nullable
default TagStatus getTagStatus()

Select images based on tags.

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

Default: TagStatus.Tagged if tagPrefixList is given, TagStatus.Any otherwise

builder

@Stability(value=Stable)
static LifecycleRule.Builder builder()

Returns:

a LifecycleRule.Builder of LifecycleRule