Repository - Get List

Service:

Container Registry

API Version:

2019-08-15-preview

List repositories

GET {url}/acr/v1/_catalog

With optional parameters:

GET {url}/acr/v1/_catalog?last={last}&n={n}

URI Parameters

Name	In	Required	Type	Description
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

Responses

Name	Type	Description
200 OK	Repositories	Returns a list of repositories Headers Link: string
Other Status Codes	AcrErrors	ACR error response describing why the operation failed.

Security

registry_auth

Type: basic

Examples

Get repositories in a registry

Sample request

HTTP

GET acrapi.azurecr-test.io/acr/v1/_catalog

Sample response

Status code:

200

{
  "repositories": [
    "production/alpine",
    "testing/alpine"
  ]
}

Definitions

Name	Description
AcrErrorInfo	Error information
AcrErrors	Acr error response describing why the operation failed
Repositories	List of repositories

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

Repositories

List of repositories

Name	Type	Description
repositories	string[]	Repository names