---
title: "Retrieve a Docker registry"
method: GET
path: "/docker_registries/{uuid}"
tags: ["docker_registry"]
---

# Retrieve a Docker registry

`GET /docker_registries/{uuid}`

Retrieve a docker registry

## Path parameters

- `uuid` string, UUID, required

## Response `200`

Success

- DockerRegistryIntentResponse — Response object for intentful operations on a docker_registry
  - `status` DockerRegistryDefStatus — Docker registry
    - `state` string — The state of the entity
    - `message_list` MessageResource[]
      - `message` string, required — If state is ERROR, a message describing the error.
      - `reason` string, required — If state is ERROR, a machine-readable snake-cased string.
      - `details` object — Custom key-value details relevant to the status.
    - `name` string, required — Name of the docker registry
    - `resources` DockerRegistryResources, required — Docker registry resources
      - `username` string, required — User name of the docker registry
      - `is_enabled` boolean — Flag to indicate whether the docker registry is enabled or not. If unset, defaults to False.
      - `certificate` string — Certificate required for the private docker registry
      - `url` string, required — URL of the docker registry
      - `password` string, required — Password of the user for the docker registry
      - `is_system_default` boolean — Flag to indicate whether the docker registry is a system default
  - `spec` DockerRegistry — Docker registry spec
    - `name` string, required — Name of the docker registry
    - `resources` DockerRegistryResources, required — Docker registry resources
      - `username` string, required — User name of the docker registry
      - `is_enabled` boolean — Flag to indicate whether the docker registry is enabled or not. If unset, defaults to False.
      - `certificate` string — Certificate required for the private docker registry
      - `url` string, required — URL of the docker registry
      - `password` string, required — Password of the user for the docker registry
      - `is_system_default` boolean — Flag to indicate whether the docker registry is a system default
  - `api_version` string, required
  - `metadata` DockerRegistryMetadata, required — The docker_registry kind metadata
    - `last_update_time` string, date-time — UTC date and time in RFC-3339 format when docker_registry was last updated
    - `kind` string, required — The kind name
    - `uuid` string, UUID — docker_registry uuid
    - `spec_version` integer — Version number of the latest spec.
    - `creation_time` string, date-time — UTC date and time in RFC-3339 format when docker_registry was created
    - `spec_hash` string — Hash of the spec. This will be returned from server.
    - `should_force_translate` boolean — Applied on Prism Central only. Indicate whether force to translate the spec of the fanout request to fit the target cluster API schema.
    - `owner_reference` UserReference — The reference to a user
      - `kind` string, required — The kind name
      - `name` string
      - `uuid` string, UUID, required
    - `categories` object — Categories for the docker_registry
    - `name` string — docker_registry name

## Other responses

- `default` — Failed to retrieve docker registry

---

[API](https://skmtc.net/nutanix/apis/nutanix-intentful-api.md) · [All operations](https://skmtc.net/nutanix/apis/nutanix-intentful-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nutanix/nutanix-intentful-api/versions/40395083ab31/schema)