v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142314899.7 KB

Informs Amazon ECR that the image layer upload is complete for a specified public registry, repository name, and upload ID. You can optionally provide a sha256 digest of the image layer for data validation purposes.

When an image is pushed, the CompleteLayerUpload API is called once for each new image layer to verify that the upload is complete.

This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

post/#X-Amz-Target=SpencerFrontendService.CompleteLayerUpload

Headers

X-Amz-Target'SpencerFrontendService.CompleteLayerUpload' required

Request body

registryIdstring

The Amazon Web Services account ID, or registry alias, associated with the registry where layers are uploaded. If you do not specify a registry, the default public registry is assumed.

repositoryNamestring required

The name of the repository in a public registry to associate with the image layer.

uploadIdstring required

The upload ID from a previous <a>InitiateLayerUpload</a> operation to associate with the image layer.

layerDigestsLayerDigest[] required

The <code>sha256</code> digest of the image layer.

Response

Success

registryIdstring

The public registry ID that's associated with the request.

repositoryNamestring

The repository name that's associated with the request.

uploadIdstring

The upload ID that's associated with the layer.

layerDigeststring

The <code>sha256</code> digest of the image layer.