post X Amz Target AmazonEC2ContainerRegistry V20150921 InitiateLayerUpload - ecr API | Specway Docs

Own AWS? Customize your docs with AI search, analytics, and more.

Claim your docs

POST

/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload

http://api.ecr.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload

<p>Notifies Amazon ECR that you intend to upload an image layer.</p> <p>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.</p> <note> <p>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 <code>docker</code> CLI to pull, tag, and push images.</p> </note>

Access Token Required: API Key

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://api.ecr.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

Own AWS? Customize your docs with AI search, analytics, and more.

Claim your docs

POST

/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload

http://api.ecr.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload

<p>Notifies Amazon ECR that you intend to upload an image layer.</p> <p>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.</p> <note> <p>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 <code>docker</code> CLI to pull, tag, and push images.</p> </note>

Access Token Required: API Key

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://api.ecr.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.InitiateLayerUpload' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}