Amazon ECR Public endpoints and quotas - AWS General Reference

Amazon ECR Public endpoints and quotas

The following are the service endpoints and service quotas for this service. To connect programmatically to an AWS service, you use an endpoint. In addition to the standard AWS endpoints, some AWS services offer FIPS endpoints in selected Regions. For more information, see AWS service endpoints. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account. For more information, see AWS service quotas.

Service endpoints

The ecr-public and api.ecr-public endpoints are used for calls to the Amazon ECR Public API. API actions such as DescribeImages and CreateRepository go to this endpoint. While the two endpoints function the same, the api.ecr-public endpoint is recommended and the default when using the AWS CLI or AWS SDKs.

Region Name Region Endpoint Protocol
US East (N. Virginia) us-east-1

ecr-public.us-east-1.amazonaws.com

api.ecr-public.us-east-1.amazonaws.com

HTTPS

HTTPS

US West (Oregon) us-west-2

ecr-public.us-west-2.amazonaws.com

api.ecr-public.us-west-2.amazonaws.com

HTTPS

HTTPS

Service quotas

The following are the service quotas for Amazon ECR Public.

Name Default Adjustable Description
Images per repository Each supported Region: 10,000 Yes The maximum number of images per repository.
Layer parts Each supported Region: 1,000 No The maximum number of layer parts. This is only applicable if you are using Amazon ECR API actions directly to initiate multipart uploads for image push operations.
Maximum layer part size Each supported Region: 10 No The maximum size (MiB) of a layer part. This is only applicable if you are using Amazon ECR API actions directly to initiate multipart uploads for image push operations.
Maximum layer size Each supported Region: 10,000 No The maximum size per layer.
Minimum layer part size Each supported Region: 5 No The minimum size (MiB) of a layer part. This is only applicable if you are using Amazon ECR API actions directly to initiate multipart uploads for image push operations.
Rate of BatchCheckLayerAvailability requests Each supported Region: 200 per second Yes The maximum number of BatchCheckLayerAvailability requests that you can make per second in the current Region. When an image is pushed to a repository, each image layer is checked to verify if it has been uploaded before. If it has been uploaded, then the image layer is skipped.
Rate of CompleteLayerUpload requests Each supported Region: 10 per second Yes The maximum number of CompleteLayerUpload requests that you can make per second in the current Region. When an image is pushed, the CompleteLayerUpload API is called once per each new image layer to verify that the upload has completed.
Rate of GetAuthorizationToken requests Each supported Region: 200 per second Yes The maximum number of GetAuthorizationToken requests that you can make per second in the current Region.
Rate of InitiateLayerUpload requests Each supported Region: 200 per second Yes The maximum number of InitiateLayerUpload requests that you can make per second in the current Region. When an image is pushed, the InitiateLayerUpload API is called once per image layer that has not already been uploaded. Whether or not an image layer has been uploaded is determined by the BatchCheckLayerAvailability API action.
Rate of PutImage requests Each supported Region: 10 per second Yes The maximum number of PutImage requests that you can make per second in the current Region. When an image is pushed and all new image layers have been uploaded, the PutImage API is called once to create or update the image manifest and the tags associated with the image.
Rate of UploadLayerPart requests Each supported Region: 260 per second Yes The maximum number of UploadLayerPart requests that you can make per second in the current Region. When an image is pushed, each new image layer is uploaded in parts and the UploadLayerPart API is called once per each new image layer part.
Rate of authenticated image pulls Each supported Region: 10 per second Yes The maximum number of authenticated image pulls per second.
Rate of image pulls to AWS resources Each supported Region: 10 per second No The maximum number of image pulls per second to resources running on Amazon ECS, Fargate, or Amazon EC2.
Rate of unauthenticated image pulls Each supported Region: 1 per second No The maximum number of unauthenticated image pulls per second.
Registered repositories Each supported Region: 10,000 Yes The maximum number of repositories that you can create in this account in the current Region.
Tags per image Each supported Region: 1,000 No The maximum number of tags per image.

For more information, see Amazon ECR Public service quotas in the Amazon ECR Public user guide.