---
title: "Retrieve the blob from the registry"
method: GET
path: "/kapis/resources.kubesphere.io/v1alpha2/registry/blob"
tags: ["Advanced Operations"]
deprecated: true
---

# Retrieve the blob from the registry

`GET /kapis/resources.kubesphere.io/v1alpha2/registry/blob`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`

> **Deprecated.**

## Query parameters

- `image` string, image=%s, required
- `namespace` string, namespace=%s
- `secret` string, secret=%s
- `insecure` string, insecure=%s

## Response `200`

ok

- RegistriesImageDetails
  - `imageBlob` RegistriesImageBlob
    - `architecture` string: The architecture field specifies the CPU architecture, for example amd64 or ppc64le.
    - `config` RegistriesConfig
      - `ArgsEscaped` boolean: Command is already escaped (Windows only)
      - `AttachStderr` boolean: Boolean value, attaches to stderr.
      - `AttachStdin` boolean: Boolean value, attaches to stdin.
      - `AttachStdout` boolean: Boolean value, attaches to stdout.
      - `Cmd` string[]: Command to run specified as a string or an array of strings.
      - `Domainname` string: A string value containing the domain name to use for the container.
      - `Entrypoint` unknown
      - `Env` string[]: A list of environment variables in the form of ["VAR=value", ...]
      - `ExposedPorts` object: An object mapping ports to an empty object in the form of: "ExposedPorts": { "<port>/<tcp|udp>: {}" }
      - `Hostname` string: A string value containing the hostname to use for the container.
      - `Image` string: A string specifying the image name to use for the container.
      - `Labels` RegistriesLabels
        - `maintainer` string, required
      - `OnBuild` unknown
      - `OpenStdin` boolean: Boolean value, opens stdin
      - `StdinOnce` boolean: Boolean value, close stdin after the 1 attached client disconnects.
      - `StopSignal` string: Signal to stop a container as a string or unsigned integer.
      - `Tty` boolean: Boolean value, Attach standard streams to a tty, including stdin if it is not closed.
      - `User` string: A string value specifying the user inside the container.
      - `Volumes` unknown
      - `WorkingDir` string: A string specifying the working directory for commands to run in.
    - `container` string: Container id.
    - `container_config` RegistriesContainerConfig
      - `ArgsEscaped` boolean: Command is already escaped (Windows only)
      - `AttachStderr` boolean: Boolean value, attaches to stderr.
      - `AttachStdin` boolean: Boolean value, attaches to stdin.
      - `AttachStdout` boolean: Boolean value, attaches to stdout.
      - `Cmd` string[]: Command to run specified as a string or an array of strings.
      - `Domainname` string: A string value containing the domain name to use for the container.
      - `Entrypoint` unknown
      - `Env` string[]: A list of environment variables in the form of ["VAR=value", ...]
      - `ExposedPorts` object: An object mapping ports to an empty object in the form of: "ExposedPorts": { "<port>/<tcp|udp>: {}" }
      - `Hostname` string: A string value containing the hostname to use for the container.
      - `Image` string: A string specifying the image name to use for the container.
      - `Labels` RegistriesLabels
        - `maintainer` string, required
      - `OnBuild` unknown
      - `OpenStdin` boolean: Boolean value, opens stdin
      - `StdinOnce` boolean: Boolean value, close stdin after the 1 attached client disconnects.
      - `StopSignal` string: Signal to stop a container as a string or unsigned integer.
      - `Tty` boolean: Boolean value, Attach standard streams to a tty, including stdin if it is not closed.
      - `User` string: A string value specifying the user inside the container.
      - `Volumes` unknown
      - `WorkingDir` string: A string specifying the working directory for commands to run in.
    - `created` string, date-time: Create time.
    - `docker_version` string: docker version.
    - `history` RegistriesHistory[]: The data of history update.
      - `created` string, date-time: Created time.
      - `created_by` string: Created command.
      - `empty_layer` boolean: Layer empty or not.
    - `os` string: Operating system.
    - `rootfs omitempty` RegistriesRootfs, required
      - `diff_ids` string[]: Contain ids of layer list
      - `type` string: Root filesystem type, always "layers"
  - `imageManifest` RegistriesImageManifest
    - `config` RegistriesManifestConfig
      - `digest` string: The digest of the content, as defined by the Registry V2 HTTP API Specificiation. Reference https://docs.docker.com/registry/spec/api/#digest-parameter
      - `mediaType` string: The MIME type of the image.
      - `size` integer: The size in bytes of the image.
    - `layers` RegistriesLayers[]: Fields of an item in the layers list.
      - `digest` string: The digest of the content, as defined by the Registry V2 HTTP API Specificiation. Reference https://docs.docker.com/registry/spec/api/#digest-parameter
      - `mediaType` string: The MIME type of the layer.
      - `size` integer: The size in bytes of the layer.
    - `mediaType` string: The MIME type of the manifest.
    - `schemaVersion` integer: This field specifies the image manifest schema version as an integer.
  - `imageTag` string: image tag.
  - `message` string: Status message.
  - `registry` string: registry domain.
  - `status` string: Status is the status of the image search, such as "succeeded".

## Changes

- **2026-07-17** `0451c8cec9b1`: 3 info
  - api operation id `handleGetRegistryEntry` removed and replaced with `GetRegistryEntry`
  - api tag `Advanced Operations` added
  - api tag `Docker Registry` removed
- **2021-08-27** `848ca03d6fdc`: 1 info
  - endpoint deprecated
- **2021-08-12** `dd7db7ac6d6b`: 1 info
  - added the new optional `query` request parameter `insecure`
- **2020-04-16** `fd6c3de5ef07`: 1 info
  - api operation id `RegistryImageBlob` removed and replaced with `handleGetRegistryEntry`
- **2019-09-12** `f444a01365a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kubesphere/apis/ks-api/changes/kapis/resources.kubesphere.io/v1alpha2/registry/blob/get.md)

---

[API](https://skmtc.dev/kubesphere/apis/ks-api.md) - [All operations](https://skmtc.dev/kubesphere/apis/ks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kubesphere/apis/ks-api/revisions/0451c8cec9b1?raw)