Expand description

Amazon Elastic Container Registry

Amazon Elastic Container Registry (Amazon ECR) is a managed container image registry service. Customers can use the familiar Docker CLI, or their preferred client, to push, pull, and manage images. Amazon ECR provides a secure, scalable, and reliable registry for your Docker or Open Container Initiative (OCI) images. Amazon ECR supports private repositories with resource-based permissions using IAM so that specific users or Amazon EC2 instances can access repositories and images.

If you’re using the service, you’re probably looking for EcrClient and Ecr.


This data type is used in the ImageScanFinding data type.

An object representing authorization data for an Amazon ECR registry.

Deletes specified images within a specified repository. Images are specified with either the imageTag or imageDigest.

An object representing a filter on a DescribeImages operation.

A client for the Amazon ECR API.

The encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.

By default, when no encryption configuration is set or the AES256 encryption type is used, Amazon ECR uses server-side encryption with Amazon S3-managed encryption keys which encrypts your data at rest using an AES-256 encryption algorithm. This does not require any action on your part.

For more control over the encryption of the contents of your repository, you can use server-side encryption with customer master keys (CMKs) stored in AWS Key Management Service (AWS KMS) to encrypt your images. For more information, see Amazon ECR encryption at rest in the Amazon Elastic Container Registry User Guide.

An object representing an Amazon ECR image.

An object that describes an image returned by a DescribeImages operation.

An object representing an Amazon ECR image failure.

An object with identifying information for an Amazon ECR image.

Contains information about an image scan finding.

The details of an image scan.

A summary of the last completed image scan.

The current status of an image scan.

The image scanning configuration for a repository.

An object representing an Amazon ECR image layer.

An object representing an Amazon ECR image layer failure.

The filter for the lifecycle policy preview.

The result of the lifecycle policy preview.

The summary of the lifecycle policy preview request.

The type of action to be taken.

An object representing a filter on a ListImages operation.

The replication configuration for a registry.

An array of objects representing the details of a replication destination.

An array of objects representing the replication destinations for a replication configuration. A replication configuration may contain only one replication rule but the rule may contain one or more replication destinations.

An object representing a repository.

The metadata that you apply to a resource to help you categorize and organize them. 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.


Errors returned by BatchCheckLayerAvailability

Errors returned by BatchDeleteImage

Errors returned by BatchGetImage

Errors returned by CompleteLayerUpload

Errors returned by CreateRepository

Errors returned by DeleteLifecyclePolicy

Errors returned by DeleteRegistryPolicy

Errors returned by DeleteRepository

Errors returned by DeleteRepositoryPolicy

Errors returned by DescribeImageScanFindings

Errors returned by DescribeImages

Errors returned by DescribeRegistry

Errors returned by DescribeRepositories

Errors returned by GetAuthorizationToken

Errors returned by GetDownloadUrlForLayer

Errors returned by GetLifecyclePolicy

Errors returned by GetLifecyclePolicyPreview

Errors returned by GetRegistryPolicy

Errors returned by GetRepositoryPolicy

Errors returned by InitiateLayerUpload

Errors returned by ListImages

Errors returned by ListTagsForResource

Errors returned by PutImage

Errors returned by PutImageScanningConfiguration

Errors returned by PutImageTagMutability

Errors returned by PutLifecyclePolicy

Errors returned by PutRegistryPolicy

Errors returned by PutReplicationConfiguration

Errors returned by SetRepositoryPolicy

Errors returned by StartImageScan

Errors returned by StartLifecyclePolicyPreview

Errors returned by TagResource

Errors returned by UntagResource

Errors returned by UploadLayerPart


Trait representing the capabilities of the Amazon ECR API. Amazon ECR clients implement this trait.