Share via

Blob - Start Upload

  • Reference
Service:
Container Registry
API Version:
2019-08-15-preview

Initiate a resumable blob upload with an empty request body.

POST {url}/v2/{name}/blobs/uploads/

URI Parameters

Name In Required Type Description
name
 path True

string

Name of the image (including the namespace)
url
 path True

string

Registry login URL

Responses

Name Type Description
202 Accepted

The upload has been created. The Location header must be used to complete the upload. The response should be identical to a GET request on the contents of the returned Location header.

Headers

  • Location: string
  • Range: string
  • Docker-Upload-UUID: string
Other Status Codes

AcrErrors

ACR error response describing why the operation failed.

Security

registry_auth

Type: basic

Examples

Start a blob upload

Sample request

POST acrapi.azurecr-test.io/v2/newimg/blobs/uploads/

Sample response

Status code:
202 
Location: /v2/blobland/blobs/uploads/f6d3451c-3352-43ff-b67c-fd0cfc793066?_nouploadcache=false&_state=iWTaVpaWiz23JTt8ZsYFPEU5JwLOFgdumWOmqGxIYGt7Ik5hbWUiOiJibG9ibGFuZCIsIlVVSUQiOiJmNmQzNDUxYy0zMzUyLTQzZmYtYjY3Yy1mZDBjZmM3OTMwNjYiLCJPZmZzZXQiOjAsIlN0YXJ0ZWRBdCI6IjIwMTktMDgtMjdUMjM6NTI6NTQuNTM1MDQ5ODY1WiJ9
Range: 0-0
Docker-Upload-Uuid: f6d3451c-3352-43ff-b67c-fd0cfc793066

Definitions

Name Description
AcrErrorInfo

Error information
AcrErrors

Acr error response describing why the operation failed

AcrErrorInfo

Error information

Name Type Description
code

string

Error code
detail

object

Error details
message

string

Error message

AcrErrors

Acr error response describing why the operation failed

Name Type Description
errors

AcrErrorInfo[]

Array of detailed error