List Docker Repositories

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 Docker repositories (the registry's _catalog) hosted in an Artifactory Docker repository.

Since: 4.4.3. The n and last pagination parameters are supported from version 5.4.6. Both parameters refer to an integer.

Security: Requires a user with read permission.

Usage: GET /api/docker/{repo-key}/v2/_catalog?n=<n from the request>&last=<last tag value from previous response>

Produces: application/json

{
  "repositories": [
    <name>,
    ...
  ]
}

Sample Usage:

GET /api/docker/docker-local/v2/_catalog
{
  "repositories": [
    "busybox",
    "centos",
    "hello-world"
  ]
}