List Docker Tags

JFrog REST APIs

Content Type
REST API

Note

Caching from Virtual Repositories: To reduce the risk of hitting rate limits, Docker tags and repository lists are served from the cache when the call is executed on a virtual repository. The caching applies to remote registries that are included in the virtual repository, with destination registries defined in the following properties:

  • artifactory.docker.cache.remote.repo.tags.and.catalog: Set to the URL of the remote registry, or a comma-separated list of remote registries, that the remote Docker repository points to.

  • retrievalCachePeriodSecs: Use this property on the remote repository configuration to adjust the cache interval setting.

Caching from Remote Repositories: When working directly with remote repositories that are not aggregated in virtual repositories, set the following system property to enable fetching cached responses:

  • artifactory.docker.catalogs.tags.fallback.fetch.remote.cache: Set to true. The default is false.

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.

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" ]
}