@swamp/aws/ecr

v2026.04.23.3

AWS ECR infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Platforms

linux-x86_64 linux-aarch64 darwin-x86_64 darwin-aarch64

Labels

awsecrcloudinfrastructure

models

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

Grade A

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types1/1earned
Has description1/1earned
At least one platform tag (or universal)1/1earned
Two or more platform tags (or universal)1/1earned
License declared1/1earned
Verified public repository2/2earned

Install

$ swamp extension pull @swamp/aws/ecr

@swamp/aws/ecr/public-repositoryv2026.04.23.2public_repository.ts

Global Arguments

Argument	Type	Required	Description
RepositoryName?	string	no	The name to use for the public 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, CFNlong generates a unique physical ID and uses that ID for the repository name. For more information, see [Name Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html). If you specify a name, you canno
RepositoryPolicyText?	string	no	The JSON repository policy text to apply to the public repository. For more information, see [Amazon ECR Public repository policies](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policies.html) in the Amazon ECR Public User Guide.
RepositoryCatalogData?	object	no	The details about the repository that are publicly visible in the Amazon ECR Public Gallery. For more information, see [Amazon ECR Public repository catalog data](https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-catalog-data.html) in the Amazon ECR Public User Guide.
Tags?	array	no	An array of key-value pairs to apply to this resource.

createCreate a ECR PublicRepository

getGet a ECR PublicRepository

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PublicRepository

updateUpdate a ECR PublicRepository

deleteDelete a ECR PublicRepository

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PublicRepository

syncSync ECR PublicRepository state from AWS

Resources

state(infinite)— ECR PublicRepository resource state

@swamp/aws/ecr/pull-through-cache-rulev2026.04.23.2pull_through_cache_rule.ts

Global Arguments

Argument	Type	Required	Description
EcrRepositoryPrefix?	string	no	The Amazon ECR repository prefix associated with the pull through cache rule.
UpstreamRegistryUrl?	string	no	The upstream registry URL associated with the pull through cache rule.
CredentialArn?	string	no	The ARN of the Secrets Manager secret associated with the pull through cache rule.
UpstreamRegistry?	string	no	The name of the upstream source registry associated with the pull through cache rule.
CustomRoleArn?	string	no	The ARN of the IAM role associated with the pull through cache rule.
UpstreamRepositoryPrefix?	string	no	The upstream repository prefix associated with the pull through cache rule.

createCreate a ECR PullThroughCacheRule

getGet a ECR PullThroughCacheRule

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PullThroughCacheRule

updateUpdate a ECR PullThroughCacheRule

deleteDelete a ECR PullThroughCacheRule

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PullThroughCacheRule

syncSync ECR PullThroughCacheRule state from AWS

Resources

state(infinite)— ECR PullThroughCacheRule resource state

@swamp/aws/ecr/pull-time-update-exclusionv2026.04.23.2pull_time_update_exclusion.ts

Global Arguments

Argument	Type	Required	Description
PrincipalArn	string	yes	The ARN of the IAM principal to remove from the pull time update exclusion list.

createCreate a ECR PullTimeUpdateExclusion

getGet a ECR PullTimeUpdateExclusion

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PullTimeUpdateExclusion

deleteDelete a ECR PullTimeUpdateExclusion

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR PullTimeUpdateExclusion

syncSync ECR PullTimeUpdateExclusion state from AWS

Resources

state(infinite)— ECR PullTimeUpdateExclusion resource state

@swamp/aws/ecr/registry-policyv2026.04.23.2registry_policy.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
PolicyText	string	yes	The JSON policy text for your registry.

createCreate a ECR RegistryPolicy

getGet a ECR RegistryPolicy

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RegistryPolicy

updateUpdate a ECR RegistryPolicy

deleteDelete a ECR RegistryPolicy

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RegistryPolicy

syncSync ECR RegistryPolicy state from AWS

Resources

state(infinite)— ECR RegistryPolicy resource state

@swamp/aws/ecr/registry-scanning-configurationv2026.04.23.2registry_scanning_configuration.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
Rules	array	yes	The scanning rules associated with the registry.
ScanType	enum	yes	The type of scanning configured for the registry.

createCreate a ECR RegistryScanningConfiguration

getGet a ECR RegistryScanningConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RegistryScanningConfiguration

updateUpdate a ECR RegistryScanningConfiguration

deleteDelete a ECR RegistryScanningConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RegistryScanningConfiguration

syncSync ECR RegistryScanningConfiguration state from AWS

Resources

state(infinite)— ECR RegistryScanningConfiguration resource state

@swamp/aws/ecr/replication-configurationv2026.04.23.2replication_configuration.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
ReplicationConfiguration	object	yes	The replication configuration for a registry.

createCreate a ECR ReplicationConfiguration

getGet a ECR ReplicationConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR ReplicationConfiguration

updateUpdate a ECR ReplicationConfiguration

deleteDelete a ECR ReplicationConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR ReplicationConfiguration

syncSync ECR ReplicationConfiguration state from AWS

Resources

state(infinite)— ECR ReplicationConfiguration resource state

@swamp/aws/ecr/repositoryv2026.04.23.2repository.ts

Global Arguments

Argument	Type	Required	Description
EmptyOnDelete?	boolean	no	If true, deleting the repository force deletes the contents of the repository. If false, the repository must be empty before attempting to delete it.
LifecyclePolicy?	object	no	Creates or updates a lifecycle policy. For information about lifecycle policy syntax, see [Lifecycle policy template](https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html).
RepositoryName?	string	no	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, CFNlong generates a unique physical ID and uses that ID for the repository name. For more information, see [Name type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html). The repository name must start with a l
RepositoryPolicyText?	string	no	The JSON repository policy text to apply to the repository. For more information, see [Amazon ECR repository policies](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) in the Amazon Elastic Container Registry User Guide.
Tags?	array	no	An array of key-value pairs to apply to this resource.
ImageTagMutability?	enum	no	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.
ImageTagMutabilityExclusionFilters?	array	no	A list of filters that specify which image tags are excluded from the repository's image tag mutability setting.
ImageScanningConfiguration?	object	no	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.
EncryptionConfiguration?	object	no	The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.

createCreate a ECR Repository

getGet a ECR Repository

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR Repository

updateUpdate a ECR Repository

deleteDelete a ECR Repository

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR Repository

syncSync ECR Repository state from AWS

Resources

state(infinite)— ECR Repository resource state

@swamp/aws/ecr/repository-creation-templatev2026.04.23.2repository_creation_template.ts

Global Arguments

Argument	Type	Required	Description
Prefix	string	yes	The repository namespace prefix associated with the repository creation template.
Description?	string	no	The description associated with the repository creation template.
ImageTagMutability?	enum	no	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.
ImageTagMutabilityExclusionFilters?	array	no	A list of filters that specify which image tags are excluded from the repository creation template's image tag mutability setting.
RepositoryPolicy?	string	no	The repository policy to apply to repositories created using the template. A repository policy is a permissions policy associated with a repository to control access permissions.
LifecyclePolicy?	string	no	The lifecycle policy to use for repositories created using the template.
EncryptionConfiguration?	object	no	The encryption configuration associated with the repository creation template.
ResourceTags?	array	no	The metadata to apply to the repository to help you categorize and organize. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
AppliedFor	array	yes	A list of enumerable Strings representing the repository creation scenarios that this template will apply towards. The supported scenarios are PULL_THROUGH_CACHE, REPLICATION, and CREATE_ON_PUSH
CustomRoleArn?	string	no	The ARN of the role to be assumed by Amazon ECR. Amazon ECR will assume your supplied role when the customRoleArn is specified. When this field isn't specified, Amazon ECR will use the service-linked role for the repository creation template.

createCreate a ECR RepositoryCreationTemplate

getGet a ECR RepositoryCreationTemplate

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RepositoryCreationTemplate

updateUpdate a ECR RepositoryCreationTemplate

deleteDelete a ECR RepositoryCreationTemplate

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR RepositoryCreationTemplate

syncSync ECR RepositoryCreationTemplate state from AWS

Resources

state(infinite)— ECR RepositoryCreationTemplate resource state

@swamp/aws/ecr/signing-configurationv2026.04.23.2signing_configuration.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
Rules	array	yes	Array of signing rules that define which repositories should be signed and with which signing profiles.

createCreate a ECR SigningConfiguration

getGet a ECR SigningConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR SigningConfiguration

updateUpdate a ECR SigningConfiguration

deleteDelete a ECR SigningConfiguration

Argument	Type	Required	Description
identifier	string	yes	The primary identifier of the ECR SigningConfiguration

syncSync ECR SigningConfiguration state from AWS

Resources

state(infinite)— ECR SigningConfiguration resource state

@swamp/aws/ecr

Repository

Platforms

Labels

Contents

Quality score

Install

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Release Notes

Release Notes

Release Notes

Release Notes

@swamp/aws/ecr

Repository

Platforms

Labels

Contents

Quality score

Install

Models9

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Global Arguments

Resources

Previous Versions5

Release Notes

Release Notes

Release Notes

Release Notes