Get a cached image

GET/images/{ref}

path parameters

object

refstringrequired

Image reference (nginx:alpine) or converted digest.

Responses

200 OKOK

ImageResponse

cmdarray

items

string

content_bytesintegerint64

convert_modestring

converted_at_unix_msintegerint64

digeststring

entriesinteger

entrypointarray

items

string

exposed_portsarray

items

string

size_bytesintegerint64

source_refstring

404 Not foundNot Found

ErrorResponse

errorstring

501 Not Implemented

ErrorResponse

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍GET/images/{ref}

cURL

curl '/images/{ref}'

JavaScript

const response = await fetch("/images/{ref}", {
  method: "GET",
});
const data = await response.json();

Python

import requests

response = requests.get(
    "/images/{ref}",
)
data = response.json()

Response

200 OK

{
  "cmd": [
    "string"
  ],
  "content_bytes": 0,
  "convert_mode": "string",
  "converted_at_unix_ms": 0,
  "digest": "string",
  "entries": 0,
  "entrypoint": [
    "string"
  ],
  "exposed_ports": [
    "string"
  ],
  "size_bytes": 0,
  "source_ref": "string"
}