mirror of https://github.com/docker/docs.git
86 lines
1.7 KiB
Markdown
86 lines
1.7 KiB
Markdown
# Registries
|
|
|
|
## Registry
|
|
|
|
> Example
|
|
|
|
```json
|
|
{
|
|
"host": "registry-1.docker.io",
|
|
"is_docker_registry": true,
|
|
"is_ssl": true,
|
|
"name": "Docker Hub",
|
|
"port": 443,
|
|
"resource_uri": "/api/repo/v1/registry/registry-1.docker.io/",
|
|
}
|
|
```
|
|
|
|
Represents a registry where repositories are hosted.
|
|
|
|
|
|
### 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
|
|
|
|
```http
|
|
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/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
|
|
|
|
```http
|
|
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/registry/(host)/`
|
|
|
|
### Path Parameters
|
|
|
|
Parameter | Description
|
|
--------- | -----------
|
|
host | The host of the registry to retrieve
|