Notifies Amazon ECR that you intend to upload an image layer.

When an image is pushed, the InitiateLayerUpload API is called once for each image layer that hasn't already been uploaded. Whether an image layer uploads is determined by the BatchCheckLayerAvailability API action.


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.

See also: AWS API Documentation

Request Syntax

response = client.initiate_layer_upload(
  • registryId (string) -- The Amazon Web Services account ID, or registry alias, that's associated with the registry to which you intend to upload layers. If you do not specify a registry, the default public registry is assumed.
  • repositoryName (string) --


    The name of the repository that you want to upload layers to.

Return type



Response Syntax

    'uploadId': 'string',
    'partSize': 123

Response Structure

  • (dict) --

    • uploadId (string) --

      The upload ID for the layer upload. This parameter is passed to further UploadLayerPart and CompleteLayerUpload operations.

    • partSize (integer) --

      The size, in bytes, that Amazon ECR expects future layer part uploads to be.


  • ECRPublic.Client.exceptions.ServerException
  • ECRPublic.Client.exceptions.InvalidParameterException
  • ECRPublic.Client.exceptions.RepositoryNotFoundException
  • ECRPublic.Client.exceptions.RegistryNotFoundException
  • ECRPublic.Client.exceptions.UnsupportedCommandException