Manifests - Get List

Service:

Container Registry

API Version:

2019-08-15-preview

List manifests of a repository

GET {url}/acr/v1/{name}/_manifests

With optional parameters:

GET {url}/acr/v1/{name}/_manifests?last={last}&n={n}&orderby={orderby}

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
last	query		string	Query parameter for the last item in previous query. Result set will include values lexically after last.
n	query		integer	query parameter for max number of items
orderby	query		string	orderby query parameter

Responses

Name	Type	Description
200 OK	AcrManifests	Returns a list of manifests
Other Status Codes	AcrErrors	ACR error response describing why the operation failed.

Security

registry_auth

Type: basic

Examples

Get list of available manifests

Sample request

HTTP

GET acrapi.azurecr-test.io/acr/v1/nanoserver/_manifests

Sample response

Status code:

200

{
  "registry": "acrapi.azurecr-test.io",
  "imageName": "nanoserver",
  "manifests": [
    {
      "digest": "sha256:110d2b6c84592561338aa040b1b14b7ab81c2f9edbd564c2285dd7d70d777086",
      "imageSize": 2401606,
      "createdTime": "2018-09-06T06:17:20.9983915Z",
      "lastUpdateTime": "2018-09-06T06:17:20.9983915Z",
      "architecture": "amd64",
      "os": "windows",
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "configMediaType": "application/vnd.docker.container.image.v1+json",
      "tags": [
        "4.7.2-20180905-nanoserver-1803"
      ],
      "changeableAttributes": {
        "deleteEnabled": true,
        "writeEnabled": true,
        "readEnabled": true,
        "listEnabled": true
      }
    },
    {
      "digest": "sha256:7af5cd1dde3e8f5c2c9103860afa4ca871a6075373b6564b0e7b1b47866dab52",
      "imageSize": 4135121,
      "createdTime": "2018-09-07T16:30:46.5651701Z",
      "lastUpdateTime": "2018-09-07T16:30:46.5651701Z",
      "architecture": "amd64",
      "os": "windows",
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "configMediaType": "application/vnd.docker.container.image.v1+json",
      "tags": [
        "4.7.2-20180906-nanoserver-1803"
      ],
      "changeableAttributes": {
        "deleteEnabled": true,
        "writeEnabled": true,
        "readEnabled": true,
        "listEnabled": true
      }
    }
  ]
}

Definitions

Name	Description
AcrErrorInfo	Error information
AcrErrors	Acr error response describing why the operation failed
AcrManifests	Manifest attributes
ManifestAttributesBase	Manifest details
ManifestChangeableAttributes	Changeable attributes

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

AcrManifests

Object

Manifest attributes

Name	Type	Description
imageName	string	Image name
manifests	ManifestAttributesBase[]	List of manifests
registry	string	Registry name

ManifestAttributesBase

Object

Manifest details

Name	Type	Description
architecture	string	CPU architecture
changeableAttributes	ManifestChangeableAttributes	Changeable attributes
configMediaType	string	Config blob media type
createdTime	string	Created time
digest	string	Manifest
imageSize	integer (int64)	Image size
lastUpdateTime	string	Last update time
mediaType	string	Media type
os	string	Operating system
tags	string[]	List of tags

ManifestChangeableAttributes

Object

Changeable attributes

Name	Type	Description
deleteEnabled	boolean	Delete enabled
listEnabled	boolean	List enabled
quarantineDetails	string	Quarantine details
quarantineState	string	Quarantine state
readEnabled	boolean	Read enabled
writeEnabled	boolean	Write enabled