Docker Engine API
  1. Image
Docker Engine API
  • System
    • Ping
      GET
    • Check auth configuration
      POST
    • Monitor events
      GET
    • Get system information
      GET
    • Get data usage information
      GET
    • Get version
      GET
  • Image
    • Build an image
      POST
    • Delete builder cache
      POST
    • Create a new image from a container
      POST
    • Create an image
      POST
    • Export several images
      GET
    • List Images
      GET
    • Import images
      POST
    • Delete unused images
      POST
    • Search images
      GET
    • Remove an image
      DELETE
    • Export an image
      GET
    • Get the history of an image
      GET
    • Inspect an image
      GET
    • Push an image
      POST
    • Tag an image
      POST
  • Config
    • List configs
      GET
    • Create a config
      POST
    • Delete a config
      DELETE
    • Inspect a config
      GET
    • Update a Config
      POST
  • Container
    • Create a container
    • List containers
    • Delete stopped containers
    • Remove a container
    • Get an archive of a filesystem resource in a container
    • Get information about files in a container
    • Extract an archive of files or folders to a directory in a container
    • Attach to a container
    • Attach to a container via a websocket
    • Get changes on a container’s filesystem
    • Export a container
    • Inspect a container
    • Kill a container
    • Get container logs
    • Pause a container
    • Rename a container
    • Resize a container TTY
    • Restart a container
    • Start a container
    • Get container stats based on resource usage
    • Stop a container
    • List processes running inside a container
    • Unpause a container
    • Update a container
    • Wait for a container
  • Exec
    • Create an exec instance
    • Inspect an exec instance
    • Resize an exec instance
    • Start an exec instance
  • Distribution
    • Get image information from the registry
  • Network
    • List networks
    • Create a network
    • Delete unused networks
    • Remove a network
    • Inspect a network
    • Connect a container to a network
    • Disconnect a container from a network
  • Node
    • List nodes
    • Delete a node
    • Inspect a node
    • Update a node
  • Plugin
    • List plugins
    • Create a plugin
    • Get plugin privileges
    • Install a plugin
    • Remove a plugin
    • Disable a plugin
    • Enable a plugin
    • Inspect a plugin
    • Push a plugin
    • Configure a plugin
    • Upgrade a plugin
  • Secret
    • List secrets
    • Create a secret
    • Delete a secret
    • Inspect a secret
    • Update a Secret
  • Service
    • List services
    • Create a service
    • Delete a service
    • Inspect a service
    • Get service logs
    • Update a service
  • Session (experimental)
    • Initialize interactive session
  • Swarm
    • Inspect swarm
    • Initialize a new swarm
    • Join an existing swarm
    • Leave a swarm
    • Unlock a locked manager
    • Get the unlock key
    • Update a swarm
  • Task
    • List tasks
    • Inspect a task
  • Volume
    • List volumes
    • Create a volume
    • Delete unused volumes
    • Remove a volume
    • Inspect a volume
  • Get task logs
    GET
  1. Image

Inspect an image

/v1.33
/v1.33
/v1.33
/v1.33
GET
/images/{name}/json
Image
Return low-level information about an image.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.33/images//json'
Response Response Example
200 - response
{
    "Architecture": "amd64",
    "Author": "",
    "Comment": "",
    "Config": {
        "AttachStderr": false,
        "AttachStdin": false,
        "AttachStdout": false,
        "Cmd": [
            "/bin/bash"
        ],
        "Domainname": "",
        "Env": [
            "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
        ],
        "Hostname": "e611e15f9c9d",
        "Image": "91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c",
        "Labels": {
            "com.example.license": "GPL",
            "com.example.vendor": "Acme",
            "com.example.version": "1.0"
        },
        "MacAddress": "",
        "NetworkDisabled": false,
        "OnBuild": [],
        "OpenStdin": false,
        "PublishService": "",
        "StdinOnce": false,
        "Tty": false,
        "User": "",
        "WorkingDir": ""
    },
    "Container": "cb91e48a60d01f1e27028b4fc6819f4f290b3cf12496c8176ec714d0d390984a",
    "ContainerConfig": {
        "AttachStderr": false,
        "AttachStdin": false,
        "AttachStdout": false,
        "Cmd": [
            "/bin/sh",
            "-c",
            "#(nop) LABEL com.example.vendor=Acme com.example.license=GPL com.example.version=1.0"
        ],
        "Domainname": "",
        "Env": [
            "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
        ],
        "Hostname": "e611e15f9c9d",
        "Image": "91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c",
        "Labels": {
            "com.example.license": "GPL",
            "com.example.vendor": "Acme",
            "com.example.version": "1.0"
        },
        "MacAddress": "",
        "NetworkDisabled": false,
        "OnBuild": [],
        "OpenStdin": false,
        "PublishService": "",
        "StdinOnce": false,
        "Tty": false,
        "User": "",
        "WorkingDir": ""
    },
    "Created": "2015-09-10T08:30:53.26995814Z",
    "DockerVersion": "1.9.0-dev",
    "GraphDriver": {
        "Data": {},
        "Name": "aufs"
    },
    "Id": "sha256:85f05633ddc1c50679be2b16a0479ab6f7637f8884e0cfe0f4d20e1ebb3d6e7c",
    "Os": "linux",
    "Parent": "sha256:91e54dfb11794fad694460162bf0cb0a4fa710cfa3f60979c177d920813e267c",
    "RepoDigests": [
        "localhost:5000/test/busybox/example@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf"
    ],
    "RepoTags": [
        "example:1.0",
        "example:latest",
        "example:stable"
    ],
    "RootFS": {
        "Layers": [
            "sha256:1834950e52ce4d5a88a1bbd131c537f4d0e56d10ff0dd69e66be3b7dfa9df7e6",
            "sha256:5f70bf18a086007016e948b04aed3b82103a36bea41755b6cddfaf10ace3c6ef"
        ],
        "Type": "layers"
    },
    "Size": 0,
    "VirtualSize": 188359297
}

Request

Path Params
name
string 
required
Image name or id

Responses

🟢200No error
application/json
Body
Architecture
string 
required
Author
string 
required
Comment
string 
required
Config
object (ContainerConfig) 
optional
Configuration for a container that is portable between hosts
ArgsEscaped
boolean 
optional
Command is already escaped (Windows only)
AttachStderr
boolean 
optional
Whether to attach to stderr.
Default:
true
AttachStdin
boolean 
optional
Whether to attach to stdin.
Default:
false
AttachStdout
boolean 
optional
Whether to attach to stdout.
Default:
true
Cmd
optional
Command to run specified as a string or an array of strings.
Domainname
string 
optional
The domain name to use for the container.
Entrypoint
optional
The entry point for the container as a string or an array of strings.
If the array consists of exactly one empty string ([""]) then the entry point is reset to system default (i.e., the entry point used by docker when there is no ENTRYPOINT instruction in the Dockerfile).
Env
array[string]
optional
A list of environment variables to set inside the container in the form ["VAR=value", ...]. A variable without = is removed from the environment, rather than to have an empty value.
ExposedPorts
object 
optional
An object mapping ports to an empty object in the form:
{"<port>/<tcp|udp>": {}}
Healthcheck
object (HealthConfig) 
optional
A test to perform to check that the container is healthy.
Hostname
string 
optional
The hostname to use for the container, as a valid RFC 1123 hostname.
Image
string 
optional
The name of the image to use when creating the container
Labels
object 
optional
User-defined key/value metadata.
MacAddress
string 
optional
MAC address of the container.
NetworkDisabled
boolean 
optional
Disable networking for the container.
OnBuild
array[string]
optional
ONBUILD metadata that were defined in the image's Dockerfile.
OpenStdin
boolean 
optional
Open stdin
Default:
false
Shell
array[string]
optional
Shell for when RUN, CMD, and ENTRYPOINT uses a shell.
StdinOnce
boolean 
optional
Close stdin after one attached client disconnects
Default:
false
StopSignal
string 
optional
Signal to stop a container as a string or unsigned integer.
Default:
SIGTERM
StopTimeout
integer 
optional
Timeout to stop a container in seconds.
Default:
10
Tty
boolean 
optional
Attach standard streams to a TTY, including stdin if it is not closed.
Default:
false
User
string 
optional
The user that commands are run as inside the container.
Volumes
object 
optional
An object mapping mount point paths inside the container to empty objects.
WorkingDir
string 
optional
The working directory for commands to run in.
Container
string 
required
ContainerConfig
object (ContainerConfig) 
optional
Configuration for a container that is portable between hosts
Created
string 
required
DockerVersion
string 
required
GraphDriver
object (GraphDriverData) 
required
Information about a container's graph driver.
Data
object 
required
Name
string 
required
Id
string 
required
Metadata
object 
optional
LastTagTime
string <dateTime>
optional
Os
string 
required
OsVersion
string 
optional
Parent
string 
required
RepoDigests
array[string]
optional
RepoTags
array[string]
optional
RootFS
object 
required
BaseLayer
string 
optional
Layers
array[string]
optional
Type
string 
required
Size
integer <int64>
required
VirtualSize
integer <int64>
required
🟠404No such image
🔴500Server error
Modified at 2022-09-10 17:56:06
Previous
Get the history of an image
Next
Push an image
Built with