Amazon Elastic Container Registry Public

/

POST

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "registryId": "string",
    "repositoryName": "string"
}'

Response Example

200 - Example 1

{
    "uploadId": "string",
    "partSize": 0
}

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

registryId

string

optional

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.

>= 2 characters<= 50 characters

repositoryName

string

required

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

>= 2 characters<= 205 characters

Match pattern:

(?:[a-z0-9]+(?:[._-][a-z0-9]+)*/)*[a-z0-9]+(?:[._-][a-z0-9]+)*

Examples

Responses

🟢200Success

application/json

Body

uploadId

string

optional

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

Match pattern:

[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}

partSize

integer

optional

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

>= 0

🟠480ServerException

🟠481InvalidParameterException

🟠482RepositoryNotFoundException

🟠483RegistryNotFoundException

🟠484UnsupportedCommandException