Get the history of an image Run in API Explorer

GET /images/{name}/history

Return parent layers of an image.

Path parameters

  • name string Required

    Image name or ID

Query parameters

  • platform string

    JSON-encoded OCI platform to select the platform-variant. If omitted, it defaults to any locally available platform, prioritizing the daemon's host platform.

    If the daemon provides a multi-platform image store, this selects the platform-variant to show the history for. If the image is a single-platform image, or if the multi-platform image does not provide a variant matching the given platform, an error is returned.

    Example: {"os": "linux", "architecture": "arm", "variant": "v5"}

Responses

  • 200 application/json

    List of image layers

    Hide response attributes Show response attributes object
    • Id string Required
    • Created integer(int64) Required
    • CreatedBy string Required
    • Tags array[string] Required
    • Size integer(int64) Required
    • Comment string Required
  • 404 application/json

    No such image

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
  • 500 application/json

    Server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
GET /images/{name}/history 
curl \
 --request GET 'http://api.example.com/v1.49/images/{name}/history'
Response examples (200) 
[
  {
    "Id": "3db9c44f45209632d6050b35958829c3a2aa256d81b9a7be45b362ff85c54710",
    "Size": 182964289,
    "Tags": [
      "ubuntu:lucid",
      "ubuntu:10.04"
    ],
    "Comment": "",
    "Created": 1398108230,
    "CreatedBy": "/bin/sh -c #(nop) ADD file:eb15dbd63394e063b805a3c32ca7bf0266ef64676d5a6fab4801f2e81e2a5148 in /"
  },
  {
    "Id": "6cfa4d1f33fb861d4d114f43b25abd0ac737509268065cdfd69d544a59c85ab8",
    "Size": 0,
    "Tags": [],
    "Comment": "",
    "Created": 1398108222,
    "CreatedBy": "/bin/sh -c #(nop) MAINTAINER Tianon Gravi <admwiggin@gmail.com> - mkimage-debootstrap.sh -i iproute,iputils-ping,ubuntu-minimal -t lucid.tar.xz lucid http://archive.ubuntu.com/ubuntu/"
  },
  {
    "Id": "511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158",
    "Size": 0,
    "Tags": [
      "scratch12:latest",
      "scratch:latest"
    ],
    "Comment": "Imported from -",
    "Created": 1371157430,
    "CreatedBy": ""
  }
]
Response examples (200) 
[
  {
    "Id": "string",
    "Created": 42,
    "CreatedBy": "string",
    "Tags": [
      "string"
    ],
    "Size": 42,
    "Comment": "string"
  }
]
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}