Container Registry Blob - Get Chunk

Service:

Container Registry

API Version:

2021-07-01

Retrieve the blob from the registry identified by digest. This endpoint may also support RFC7233 compliant range requests. Support can be detected by issuing a HEAD request. If the header Accept-Range: bytes is returned, range requests can be used to fetch partial content.

GET {endpoint}/v2/{name}/blobs/{digest}?_overload=getChunk&api-version=2021-07-01

URI Parameters

Name	In	Required	Type	Description
digest	path	True	string	Digest of a BLOB
endpoint	path	True	string (uri)
name	path	True	string	Name of the image (including the namespace)
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Header

Name	Required	Type	Description
range	True	string	Format : bytes=<start>-<end>, HTTP Range header specifying blob chunk.

Responses

Name	Type	Description
Other Status Codes	file	Successful Media Types: "application/octet-stream", "application/json" Headers Content-Length: integer Content-Range: string
Other Status Codes	AcrErrors	An unexpected error response. Media Types: "application/octet-stream", "application/json"

Security

OAuth2Auth

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://containerregistry.azure.net/.default

Examples

Get a blob Chunk

Sample request

HTTP

GET {endpoint}/v2/prod/bash/blobs/sha256:16463e0c481e161aabb735437d30b3c9c7391c2747cc564bb927e843b73dcb39?_overload=getChunk&api-version=2021-07-01

Sample response

Status code:

206

Content-Length: 300
Content-Range: bytes 0-299/5635

"eyJhcmNoaXRlY3R1cmUiOiJhbWQ2NCIsImNvbmZpZyI6eyJIb3N0bmFtZSI6IiIsIkRvbWFpbm5hbWUiOiIiLCJVc2VyIjoiIiwiQXR0YWNoU3RkaW4iOmZhbHNlLCJBdHRhY2hTdGRvdXQiOmZhbHNlLCJBdHRhY2hTdGRlcnIiOmZhbHNlLCJUdHkiOmZhbHNlLCJPcGVuU3RkaW4iOmZhbHNlLCJTdGRpbk9uY2UiOmZhbHNlLCJFbnYiOlsiUEFUSD0vdXNyL2xvY2FsL3NiaW46L3Vzci9sb2NhbC9iaW46L3Vzci9zYmluOi91c3IvYmluOi9zYmluOi9iaW4iLCJfQkFTSF9HUEdfS0VZPTdDMDEzNUZCMDg4QUFGNkM2NkM2NTBCOUJC"

Definitions

Name	Description
AcrErrorInfo	Error information
AcrErrors	Acr error response describing why the operation failed

AcrErrorInfo

Object

Error information

Name	Type	Description
code	string	Error code
detail	object	Error details
message	string	Error message

AcrErrors

Object

Acr error response describing why the operation failed

Name	Type	Description
errors	AcrErrorInfo[]	Array of detailed error