Tag - Get List

Service:

Container Registry

API Version:

2019-08-15-preview

List tags of a repository

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

With optional parameters:

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

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
digest	query		string	filter by digest
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	TagList	Tag details of a repository
Other Status Codes	AcrErrors	ACR error response describing why the operation failed.

Security

registry_auth

Type: basic

Examples

Get tags of a repository

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "registry": "acrapi.azurecr-test.io",
  "imageName": "nanoserver",
  "tags": [
    {
      "name": "4.7.2-20180905-nanoserver-1803",
      "digest": "sha256:110d2b6c84592561338aa040b1b14b7ab81c2f9edbd564c2285dd7d70d777086",
      "createdTime": "2018-09-06T06:17:21.0856539Z",
      "lastUpdateTime": "2018-09-06T06:17:21.0856539Z",
      "signed": false,
      "changeableAttributes": {
        "deleteEnabled": true,
        "writeEnabled": true,
        "readEnabled": true,
        "listEnabled": true
      }
    },
    {
      "name": "4.7.2-20180906-nanoserver-1803",
      "digest": "sha256:7af5cd1dde3e8f5c2c9103860afa4ca871a6075373b6564b0e7b1b47866dab52",
      "createdTime": "2018-09-06T16:30:43.3860166Z",
      "lastUpdateTime": "2018-09-07T16:30:46.7022734Z",
      "signed": false,
      "changeableAttributes": {
        "deleteEnabled": true,
        "writeEnabled": true,
        "readEnabled": true,
        "listEnabled": true
      }
    }
  ]
}

Definitions

Name	Description
AcrErrorInfo	Error information
AcrErrors	Acr error response describing why the operation failed
TagAttributesBase	Tag attribute details
TagChangeableAttributes
TagList	List of tag details

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

TagAttributesBase

Tag attribute details

Name	Type	Description
changeableAttributes	TagChangeableAttributes	Tag Changeable attributes
createdTime	string	Tag created time
digest	string	Tag digest
lastUpdateTime	string	Tag last update time
name	string	Tag name
signed	boolean	Is signed

TagChangeableAttributes

Name	Type	Description
deleteEnabled	boolean	Delete enabled
listEnabled	boolean	List enabled
readEnabled	boolean	Read enabled
writeEnabled	boolean	Write enabled

TagList

List of tag details

Name	Type	Description
imageName	string	Image name
registry	string	Registry name
tags	TagAttributesBase[]	List of tag attribute details