Package software.amazon.awscdk.services.ecr

Interface CfnRepositoryProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnRepositoryProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)",
           date="2025-12-12T17:54:12.411Z")
@Stability(Stable)
public interface CfnRepositoryProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnRepository.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.ecr.*;
 Object repositoryPolicyText;
 CfnRepositoryProps cfnRepositoryProps = CfnRepositoryProps.builder()
         .emptyOnDelete(false)
         .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                 .encryptionType("encryptionType")
                 // the properties below are optional
                 .kmsKey("kmsKey")
                 .build())
         .imageScanningConfiguration(ImageScanningConfigurationProperty.builder()
                 .scanOnPush(false)
                 .build())
         .imageTagMutability("imageTagMutability")
         .imageTagMutabilityExclusionFilters(List.of(ImageTagMutabilityExclusionFilterProperty.builder()
                 .imageTagMutabilityExclusionFilterType("imageTagMutabilityExclusionFilterType")
                 .imageTagMutabilityExclusionFilterValue("imageTagMutabilityExclusionFilterValue")
                 .build()))
         .lifecyclePolicy(LifecyclePolicyProperty.builder()
                 .lifecyclePolicyText("lifecyclePolicyText")
                 .registryId("registryId")
                 .build())
         .repositoryName("repositoryName")
         .repositoryPolicyText(repositoryPolicyText)
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static CfnRepositoryProps.Builder	builder()
default Object	getEmptyOnDelete()	If true, deleting the repository force deletes the contents of the repository.
default Object	getEncryptionConfiguration()	The encryption configuration for the repository.
default Object	getImageScanningConfiguration()
default String	getImageTagMutability()	The tag mutability setting for the repository.
default Object	getImageTagMutabilityExclusionFilters()	A list of filters that specify which image tags are excluded from the repository's image tag mutability setting.
default Object	getLifecyclePolicy()	Creates or updates a lifecycle policy.
default String	getRepositoryName()	The name to use for the repository.
default Object	getRepositoryPolicyText()	The JSON repository policy text to apply to the repository.
default List<CfnTag>	getTags()	An array of key-value pairs to apply to this resource.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getEmptyOnDelete

@Stability(Stable)
@Nullable
default Object getEmptyOnDelete()

If true, deleting the repository force deletes the contents of the repository.

If false, the repository must be empty before attempting to delete it.

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-emptyondelete

getEncryptionConfiguration

@Stability(Stable)
@Nullable
default Object getEncryptionConfiguration()

The encryption configuration for the repository.

This determines how the contents of your repository are encrypted at rest.

Returns union: either IResolvable or CfnRepository.EncryptionConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-encryptionconfiguration

getImageScanningConfiguration

@Stability(Stable)
@Nullable
default Object getImageScanningConfiguration()

The imageScanningConfiguration parameter is being deprecated, in favor of specifying the image scanning configuration at the registry level.

For more information, see PutRegistryScanningConfiguration .

The image scanning configuration for the repository. This determines whether images are scanned for known vulnerabilities after being pushed to the repository.

Returns union: either IResolvable or CfnRepository.ImageScanningConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-imagescanningconfiguration

getImageTagMutability

@Stability(Stable)
@Nullable
default String getImageTagMutability()

The tag mutability setting for the repository.

If this parameter is omitted, the default setting of MUTABLE will be used which will allow image tags to be overwritten. If IMMUTABLE is specified, all image tags within the repository will be immutable which will prevent them from being overwritten.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-imagetagmutability

getImageTagMutabilityExclusionFilters

@Stability(Stable)
@Nullable
default Object getImageTagMutabilityExclusionFilters()

A list of filters that specify which image tags are excluded from the repository's image tag mutability setting.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnRepository.ImageTagMutabilityExclusionFilterProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-imagetagmutabilityexclusionfilters

getLifecyclePolicy

@Stability(Stable)
@Nullable
default Object getLifecyclePolicy()

Creates or updates a lifecycle policy.

For information about lifecycle policy syntax, see Lifecycle policy template .

Returns union: either IResolvable or CfnRepository.LifecyclePolicyProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-lifecyclepolicy

getRepositoryName

@Stability(Stable)
@Nullable
default String getRepositoryName()

The name to use for the repository.

The repository name may be specified on its own (such as nginx-web-app ) or it can be prepended with a namespace to group the repository into a category (such as project-a/nginx-web-app ). If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the repository name. For more information, see Name type .

The repository name must start with a letter and can only contain lowercase letters, numbers, hyphens, underscores, and forward slashes.

If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-repositoryname

getRepositoryPolicyText

@Stability(Stable)
@Nullable
default Object getRepositoryPolicyText()

The JSON repository policy text to apply to the repository.

For more information, see Amazon ECR repository policies in the Amazon Elastic Container Registry User Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-repositorypolicytext

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

An array of key-value pairs to apply to this resource.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecr-repository.html#cfn-ecr-repository-tags

builder

@Stability(Stable)
static CfnRepositoryProps.Builder builder()

Returns:

a CfnRepositoryProps.Builder of CfnRepositoryProps