List Docker Tags

JFrog REST APIs

Content Type
REST API
ft:sourceType
Paligo

Description: Lists all tags of the specified Artifactory Docker repository.

Since: 4.4.3. The n and last pagination parameters are supported from version 5.4.6.

Notes on List Docker Tags

  • Requires JFrog Container Registry or Artifactory Pro

  • To enable fetch from cache using the ListDockerRepositories and the ListDockerTags rest APIs, set the artifactory.docker.catalogs.tags.fallback.fetch.remote.cache system property to true (default false) in the artifactory.system.properties file.

  • For Artifactory versions 7.90.1 and above, Artifactory will only return tags that comply with the OCI and Docker naming specifications. To disable this feature and return all tags, set the following feature flag in your system configuration file:

    aritfactory.docker.filter.digests.from.tags.list.enabled=false

    For more information, see OCI Specifications and Docker Image Tag.

Security: Requires a privileged user

Usage: GET /api/docker/{repo-key}/v2/{image name}/tags/list?n=<Number of consecutive tags>&last=<last tag position (numeric) from previous response>

Produces: application/json

{
  "name": "<image name>",
  "tags" : ["<tag>"]
}

Sample Usage:

GET /api/docker/{repo-key}/v2/{image name}/tags/list?n=<number of consecutive tags>&last=<last tag position (numeric) from previous response>
{
  "name" : "postgres",
  "tags" : [ "9.5.2" ]
}