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.
Notes on List Docker Repositories
Requires JFrog Container Registry or Artifactory Pro
To enable fetching from the cache using the ListDockerRepositories and the ListDockerTags rest APIs, you will need to set the following system properties in the
artifactory.system.properties
file:Set
artifactory.docker.catalogs.tags.fallback.fetch.remote.cache
totrue
(the default is false)Set
artifactory.docker.cache.remote.repo.tags.and.catalog=https://registry-1.docker.io/
This property should reference the URL of the remote registry to which the remote docker repositories point. Use the
retrievalCachePeriodSecs
property to adjust the cache interval setting.
Security: Requires a privileged user
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" ] }