Note:
You are viewing the documentation for an older major version of the AWS CLI (version 1). To view this page for the AWS CLI version 2, click here.AWS CLI v1 entered maintenance mode on August 5, 2026 and will reach end-of-support on July 15, 2027. During maintenance mode, releases are limited to critical bug fixes and security issues. AWS CLI v1 will not receive API updates for new or existing services, or be updated to support new regions. For more information, see the maintenance mode announcement.
We recommend that you migrate to AWS CLI version 2. See the installation instructions and migration guide.
[ aws ]
ecr¶
Description¶
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.
Amazon ECR has service endpoints in each supported Region. For more information, see Amazon ECR endpoints in the Amazon Web Services General Reference .
Available Commands¶
- batch-check-layer-availability
- batch-delete-image
- batch-get-image
- batch-get-repository-scanning-configuration
- complete-layer-upload
- create-pull-through-cache-rule
- create-repository
- create-repository-creation-template
- delete-lifecycle-policy
- delete-pull-through-cache-rule
- delete-registry-policy
- delete-repository
- delete-repository-creation-template
- delete-repository-policy
- delete-signing-configuration
- deregister-pull-time-update-exclusion
- describe-image-replication-status
- describe-image-scan-findings
- describe-image-signing-status
- describe-images
- describe-pull-through-cache-rules
- describe-registry
- describe-repositories
- describe-repository-creation-templates
- get-account-setting
- get-authorization-token
- get-download-url-for-layer
- get-lifecycle-policy
- get-lifecycle-policy-preview
- get-login
- get-login-password
- get-registry-policy
- get-registry-scanning-configuration
- get-repository-policy
- get-signing-configuration
- initiate-layer-upload
- list-image-referrers
- list-images
- list-pull-time-update-exclusions
- list-tags-for-resource
- put-account-setting
- put-image
- put-image-scanning-configuration
- put-image-tag-mutability
- put-lifecycle-policy
- put-registry-policy
- put-registry-scanning-configuration
- put-replication-configuration
- put-signing-configuration
- register-pull-time-update-exclusion
- set-repository-policy
- start-image-scan
- start-lifecycle-policy-preview
- tag-resource
- untag-resource
- update-image-storage-class
- update-pull-through-cache-rule
- update-repository-creation-template
- upload-layer-part
- validate-pull-through-cache-rule
- wait