Registries

Registry

Example

{
  "host": "registry-1.docker.io",
  "is_docker_registry": true,
  "is_ssl": true,
  "name": "Docker Hub",
  "port": 443,
  "resource_uri": "/api/repo/v1/user_namespace/registry/registry-1.docker.io/"
}

Represents a registry where repositories are hosted.

This is a namespaced endpoint.

Attributes

Attribute	Description
resource_uri	A unique API endpoint that represents the registry
name	Human-readable name of the registry
host	FQDN of the registry, i.e. registry-1.docker.io
is_docker_registry	Whether this registry is run by Docker
is_ssl	Whether this registry has SSL activated or not
port	The port number where the registry is listening to

List all registries

GET /api/repo/v1/registry/ HTTP/1.1
Host: cloud.docker.com
Authorization: Basic dXNlcm5hbWU6YXBpa2V5
Accept: application/json

Lists all current registries. Returns a list of Registry objects.

Endpoint Type

Available in Docker Cloud’s REST API

HTTP Request

GET /api/repo/v1/[optional_namespace/]registry/

Query Parameters

Parameter	Description
uuid	Filter by UUID
name	Filter by registry name
host	Filter by registry host
is_docker_registry	Filter by whether the registry is run by Docker or not. Possible values: ‘true’ or 'false’

Get an existing registry

GET /api/repo/v1/registry/registry-1.docker.io/ HTTP/1.1
Host: cloud.docker.com
Authorization: Basic dXNlcm5hbWU6YXBpa2V5
Accept: application/json

Gets all the details of an specific registry

Endpoint Type

Available in Docker Cloud’s REST API

HTTP Request

GET /api/v1/[optional_namespace/]registry/(host)/

Path Parameters

Parameter	Description
host	The host of the registry to retrieve