NAV

# 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