---
title: "Inspect a container"
method: GET
path: "/containers/{id}/json"
tags: ["Container"]
---

# Inspect a container

`GET /containers/{id}/json`

Return low-level information about a container.

## Path parameters

- `id` string, required

## Query parameters

- `size` boolean

## Response `200`

no error

- ContainerInspectResponse
  - `Id` string — The ID of this container as a 128-bit (64-character) hexadecimal string (32 bytes).
  - `Created` string, dateTime, nullable — Date and time at which the container was created, formatted in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format with nano-seconds.
  - `Path` string — The path to the command being run
  - `Args` string[] — The arguments to the command being run
  - `State` ContainerState, nullable — ContainerState stores container's running state. It's part of ContainerJSONBase and will be returned by the "inspect" command.
    - `Status` 'created' | 'running' | 'paused' | 'restarting' | 'removing' | 'exited' | 'dead' — String representation of the container state. Can be one of "created", "running", "paused", "restarting", "removing", "exited", or "dead".
    - `Running` boolean — Whether this container is running. Note that a running container can be _paused_. The `Running` and `Paused` booleans are not mutually exclusive: When pausing a container (on Linux), the freezer cgroup is used to suspend all processes in the container. Freezing the process requires the process to be running. As a result, paused containers are both `Running` _and_ `Paused`. Use the `Status` field instead to determine if a container's state is "running".
    - `Paused` boolean — Whether this container is paused.
    - `Restarting` boolean — Whether this container is restarting.
    - `OOMKilled` boolean — Whether a process within this container has been killed because it ran out of memory since the container was last started.
    - `Dead` boolean
    - `Pid` integer — The process ID of this container
    - `ExitCode` integer — The last exit code of this container
    - `Error` string
    - `StartedAt` string — The time when this container was last started.
    - `FinishedAt` string — The time when this container last exited.
    - `Health` Health, nullable — Health stores information about the container's healthcheck results.
      - `Status` 'none' | 'starting' | 'healthy' | 'unhealthy' — Status is one of `none`, `starting`, `healthy` or `unhealthy` - "none" Indicates there is no healthcheck - "starting" Starting indicates that the container is not yet ready - "healthy" Healthy indicates that the container is running correctly - "unhealthy" Unhealthy indicates that the container has a problem
      - `FailingStreak` integer — FailingStreak is the number of consecutive failures
      - `Log` HealthcheckResult[] — Log contains the last few results (oldest first)
        - `Start` string, date-time — Date and time at which this check started in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format with nano-seconds.
        - `End` string, dateTime — Date and time at which this check ended in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format with nano-seconds.
        - `ExitCode` integer — ExitCode meanings: - `0` healthy - `1` unhealthy - `2` reserved (considered unhealthy) - other values: error running probe
        - `Output` string — Output from last check
  - `Image` string — The ID (digest) of the image that this container was created from.
  - `ResolvConfPath` string — Location of the `/etc/resolv.conf` generated for the container on the host. This file is managed through the docker daemon, and should not be accessed or modified by other tools.
  - `HostnamePath` string — Location of the `/etc/hostname` generated for the container on the host. This file is managed through the docker daemon, and should not be accessed or modified by other tools.
  - `HostsPath` string — Location of the `/etc/hosts` generated for the container on the host. This file is managed through the docker daemon, and should not be accessed or modified by other tools.
  - `LogPath` string, nullable — Location of the file used to buffer the container's logs. Depending on the logging-driver used for the container, this field may be omitted. This file is managed through the docker daemon, and should not be accessed or modified by other tools.
  - `Name` string — The name associated with this container. For historic reasons, the name may be prefixed with a forward-slash (`/`).
  - `RestartCount` integer — Number of times the container was restarted since it was created, or since daemon was started.
  - `Driver` string — The storage-driver used for the container's filesystem (graph-driver or snapshotter).
  - `Platform` string — The platform (operating system) for which the container was created. This field was introduced for the experimental "LCOW" (Linux Containers On Windows) features, which has been removed. In most cases, this field is equal to the host's operating system (`linux` or `windows`).
  - `ImageManifestDescriptor` OCIDescriptor — A descriptor struct containing digest, media type, and size, as defined in the [OCI Content Descriptors Specification](https://github.com/opencontainers/image-spec/blob/v1.0.1/descriptor.md).
    - `mediaType` string — The media type of the object this schema refers to.
    - `digest` string — The digest of the targeted content.
    - `size` integer — The size in bytes of the blob.
    - `urls` string[], nullable — List of URLs from which this object MAY be downloaded.
    - `annotations` object, nullable — Arbitrary metadata relating to the targeted content.
    - `data` string, nullable — Data is an embedding of the targeted content. This is encoded as a base64 string when marshalled to JSON (automatically, by encoding/json). If present, Data can be used directly to avoid fetching the targeted content.
    - `platform` OCIPlatform, nullable — Describes the platform which the image in the manifest runs on, as defined in the [OCI Image Index Specification](https://github.com/opencontainers/image-spec/blob/v1.0.1/image-index.md).
      - `architecture` string — The CPU architecture, for example `amd64` or `ppc64`.
      - `os` string — The operating system, for example `linux` or `windows`.
      - `os.version` string — Optional field specifying the operating system version, for example on Windows `10.0.19041.1165`.
      - `os.features` string[] — Optional field specifying an array of strings, each listing a required OS feature (for example on Windows `win32k`).
      - `variant` string — Optional field specifying a variant of the CPU, for example `v7` to specify ARMv7 when architecture is `arm`.
    - `artifactType` string, nullable — ArtifactType is the IANA media type of this artifact.
  - `MountLabel` string — SELinux mount label set for the container.
  - `ProcessLabel` string — SELinux process label set for the container.
  - `AppArmorProfile` string — The AppArmor profile set for the container.
  - `ExecIDs` string[], nullable — IDs of exec instances that are running in the container.
  - `HostConfig` HostConfig — A container's resources (cgroups config, ulimits, etc)
    - `CpuShares` integer — An integer value representing this container's relative CPU weight versus other containers.
    - `Memory` integer — Memory limit in bytes.
    - `CgroupParent` string — Path to `cgroups` under which the container's `cgroup` is created. If the path is not absolute, the path is considered to be relative to the `cgroups` path of the init process. Cgroups are created if they do not already exist.
    - `BlkioWeight` integer — Block IO weight (relative weight).
    - `BlkioWeightDevice` object[] — Block IO weight (relative device weight) in the form: ``` [{"Path": "device_path", "Weight": weight}] ```
      - `Path` string
      - `Weight` integer
    - `BlkioDeviceReadBps` ThrottleDevice[] — Limit read rate (bytes per second) from a device, in the form: ``` [{"Path": "device_path", "Rate": rate}] ```
      - `Path` string — Device path
      - `Rate` integer — Rate
    - `BlkioDeviceWriteBps` ThrottleDevice[] — Limit write rate (bytes per second) to a device, in the form: ``` [{"Path": "device_path", "Rate": rate}] ```
      - `Path` string — Device path
      - `Rate` integer — Rate
    - `BlkioDeviceReadIOps` ThrottleDevice[] — Limit read rate (IO per second) from a device, in the form: ``` [{"Path": "device_path", "Rate": rate}] ```
      - `Path` string — Device path
      - `Rate` integer — Rate
    - `BlkioDeviceWriteIOps` ThrottleDevice[] — Limit write rate (IO per second) to a device, in the form: ``` [{"Path": "device_path", "Rate": rate}] ```
      - `Path` string — Device path
      - `Rate` integer — Rate
    - `CpuPeriod` integer — The length of a CPU period in microseconds.
    - `CpuQuota` integer — Microseconds of CPU time that the container can get in a CPU period.
    - `CpuRealtimePeriod` integer — The length of a CPU real-time period in microseconds. Set to 0 to allocate no time allocated to real-time tasks.
    - `CpuRealtimeRuntime` integer — The length of a CPU real-time runtime in microseconds. Set to 0 to allocate no time allocated to real-time tasks.
    - `CpusetCpus` string — CPUs in which to allow execution (e.g., `0-3`, `0,1`).
    - `CpusetMems` string — Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems.
    - `Devices` DeviceMapping[] — A list of devices to add to the container.
      - `PathOnHost` string
      - `PathInContainer` string
      - `CgroupPermissions` string
    - `DeviceCgroupRules` string[] — a list of cgroup rules to apply to the container
    - `DeviceRequests` DeviceRequest[] — A list of requests for devices to be sent to device drivers.
      - `Driver` string
      - `Count` integer
      - `DeviceIDs` string[]
      - `Capabilities` array[] — A list of capabilities; an OR list of AND lists of capabilities.
        - string[]
      - `Options` object — Driver-specific options, specified as a key/value pairs. These options are passed directly to the driver.
    - `KernelMemoryTCP` integer — Hard limit for kernel TCP buffer memory (in bytes). Depending on the OCI runtime in use, this option may be ignored. It is no longer supported by the default (runc) runtime. This field is omitted when empty.
    - `MemoryReservation` integer — Memory soft limit in bytes.
    - `MemorySwap` integer — Total memory limit (memory + swap). Set as `-1` to enable unlimited swap.
    - `MemorySwappiness` integer — Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100.
    - `NanoCpus` integer — CPU quota in units of 10<sup>-9</sup> CPUs.
    - `OomKillDisable` boolean — Disable OOM Killer for the container.
    - `Init` boolean, nullable — Run an init inside the container that forwards signals and reaps processes. This field is omitted if empty, and the default (as configured on the daemon) is used.
    - `PidsLimit` integer, nullable — Tune a container's PIDs limit. Set `0` or `-1` for unlimited, or `null` to not change.
    - `Ulimits` object[] — A list of resource limits to set in the container. For example: ``` {"Name": "nofile", "Soft": 1024, "Hard": 2048} ```
      - `Name` string — Name of ulimit
      - `Soft` integer — Soft limit
      - `Hard` integer — Hard limit
    - `CpuCount` integer — The number of usable CPUs (Windows only). On Windows Server containers, the processor resource controls are mutually exclusive. The order of precedence is `CPUCount` first, then `CPUShares`, and `CPUPercent` last.
    - `CpuPercent` integer — The usable percentage of the available CPUs (Windows only). On Windows Server containers, the processor resource controls are mutually exclusive. The order of precedence is `CPUCount` first, then `CPUShares`, and `CPUPercent` last.
    - `IOMaximumIOps` integer — Maximum IOps for the container system drive (Windows only)
    - `IOMaximumBandwidth` integer — Maximum IO in bytes per second for the container system drive (Windows only).
    - `Binds` string[] — A list of volume bindings for this container. Each volume binding is a string in one of these forms: - `host-src:container-dest[:options]` to bind-mount a host path into the container. Both `host-src`, and `container-dest` must be an _absolute_ path. - `volume-name:container-dest[:options]` to bind-mount a volume managed by a volume driver into the container. `container-dest` must be an _absolute_ path. `options` is an optional, comma-delimited list of: - `nocopy` disables automatic copying of data from the container path to the volume. The `nocopy` flag only applies to named volumes. - `[ro|rw]` mounts a volume read-only or read-write, respectively. If omitted or set to `rw`, volumes are mounted read-write. - `[z|Z]` applies SELinux labels to allow or deny multiple containers to read and write to the same volume. - `z`: a _shared_ content label is applied to the content. This label indicates that multiple containers can share the volume content, for both reading and writing. - `Z`: a _private unshared_ label is applied to the content. This label indicates that only the current container can use a private volume. Labeling systems such as SELinux require proper labels to be placed on volume content that is mounted into a container. Without a label, the security system can prevent a container's processes from using the content. By default, the labels set by the host operating system are not modified. - `[[r]shared|[r]slave|[r]private]` specifies mount [propagation behavior](https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt). This only applies to bind-mounted volumes, not internal volumes or named volumes. Mount propagation requires the source mount point (the location where the source directory is mounted in the host operating system) to have the correct propagation properties. For shared volumes, the source mount point must be set to `shared`. For slave volumes, the mount must be set to either `shared` or `slave`.
    - `ContainerIDFile` string — Path to a file where the container ID is written
    - `LogConfig` object — The logging configuration for this container
      - `Type` 'local' | 'json-file' | 'syslog' | 'journald' | 'gelf' | 'fluentd' | 'awslogs' | 'splunk' | 'etwlogs' | 'none' — Name of the logging driver used for the container or "none" if logging is disabled.
      - `Config` object — Driver-specific configuration options for the logging driver.
    - `NetworkMode` string — Network mode to use for this container. Supported standard values are: `bridge`, `host`, `none`, and `container:<name|id>`. Any other value is taken as a custom network's name to which this container should connect to.
    - `PortBindings` PortMap — PortMap describes the mapping of container ports to host ports, using the container's port-number and protocol as key in the format `<port>/<protocol>`, for example, `80/udp`. If a container's port is mapped for multiple protocols, separate entries are added to the mapping table.
    - `RestartPolicy` RestartPolicy — The behavior to apply when the container exits. The default is not to restart. An ever increasing delay (double the previous delay, starting at 100ms) is added before each restart to prevent flooding the server.
      - `Name` '' | 'no' | 'always' | 'unless-stopped' | 'on-failure' — - Empty string means not to restart - `no` Do not automatically restart - `always` Always restart - `unless-stopped` Restart always except when the user has manually stopped the container - `on-failure` Restart only when the container exit code is non-zero
      - `MaximumRetryCount` integer — If `on-failure` is used, the number of times to retry before giving up.
    - `AutoRemove` boolean — Automatically remove the container when the container's process exits. This has no effect if `RestartPolicy` is set.
    - `VolumeDriver` string — Driver that this container uses to mount volumes.
    - `VolumesFrom` string[] — A list of volumes to inherit from another container, specified in the form `<container name>[:<ro|rw>]`.
    - `Mounts` Mount[] — Specification for mounts to be added to the container.
      - `Target` string — Container path.
      - `Source` string — Mount source (e.g. a volume name, a host path).
      - `Type` 'bind' | 'volume' | 'image' | 'tmpfs' | 'npipe' | 'cluster' — The mount type. Available types: - `bind` Mounts a file or directory from the host into the container. Must exist prior to creating the container. - `volume` Creates a volume with the given name and options (or uses a pre-existing volume with the same name and options). These are **not** removed when the container is removed. - `image` Mounts an image. - `tmpfs` Create a tmpfs with the given options. The mount source cannot be specified for tmpfs. - `npipe` Mounts a named pipe from the host into the container. Must exist prior to creating the container. - `cluster` a Swarm cluster volume
      - `ReadOnly` boolean — Whether the mount should be read-only.
      - `Consistency` string — The consistency requirement for the mount: `default`, `consistent`, `cached`, or `delegated`.
      - `BindOptions` object — Optional configuration for the `bind` type.
        - `Propagation` 'private' | 'rprivate' | 'shared' | 'rshared' | 'slave' | 'rslave' — A propagation mode with the value `[r]private`, `[r]shared`, or `[r]slave`.
        - `NonRecursive` boolean — Disable recursive bind mount.
        - `CreateMountpoint` boolean — Create mount point on host if missing
        - `ReadOnlyNonRecursive` boolean — Make the mount non-recursively read-only, but still leave the mount recursive (unless NonRecursive is set to `true` in conjunction). Added in v1.44, before that version all read-only mounts were non-recursive by default. To match the previous behaviour this will default to `true` for clients on versions prior to v1.44.
        - `ReadOnlyForceRecursive` boolean — Raise an error if the mount cannot be made recursively read-only.
      - `VolumeOptions` object — Optional configuration for the `volume` type.
        - `NoCopy` boolean — Populate volume with data from the target.
        - `Labels` object — User-defined key/value metadata.
        - `DriverConfig` object — Map of driver specific options
          - `Name` string — Name of the driver to use to create the volume.
          - `Options` object — key/value map of driver specific options.
        - `Subpath` string — Source path inside the volume. Must be relative without any back traversals.
      - `ImageOptions` object — Optional configuration for the `image` type.
        - `Subpath` string — Source path inside the image. Must be relative without any back traversals.
      - `TmpfsOptions` object — Optional configuration for the `tmpfs` type.
        - `SizeBytes` integer — The size for the tmpfs mount in bytes.
        - `Mode` integer — The permission mode for the tmpfs mount in an integer.
        - `Options` array[] — The options to be passed to the tmpfs mount. An array of arrays. Flag options should be provided as 1-length arrays. Other types should be provided as as 2-length arrays, where the first item is the key and the second the value.
          - string[]
    - `ConsoleSize` integer[], nullable — Initial console size, as an `[height, width]` array.
    - `Annotations` object — Arbitrary non-identifying metadata attached to container and provided to the runtime when the container is started.
    - `CapAdd` string[] — A list of kernel capabilities to add to the container. Conflicts with option 'Capabilities'.
    - `CapDrop` string[] — A list of kernel capabilities to drop from the container. Conflicts with option 'Capabilities'.
    - `CgroupnsMode` 'private' | 'host' — cgroup namespace mode for the container. Possible values are: - `"private"`: the container runs in its own private cgroup namespace - `"host"`: use the host system's cgroup namespace If not specified, the daemon default is used, which can either be `"private"` or `"host"`, depending on daemon version, kernel support and configuration.
    - `Dns` string[] — A list of DNS servers for the container to use.
    - `DnsOptions` string[] — A list of DNS options.
    - `DnsSearch` string[] — A list of DNS search domains.
    - `ExtraHosts` string[] — A list of hostnames/IP mappings to add to the container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`.
    - `GroupAdd` string[] — A list of additional groups that the container process will run as.
    - `IpcMode` string — IPC sharing mode for the container. Possible values are: - `"none"`: own private IPC namespace, with /dev/shm not mounted - `"private"`: own private IPC namespace - `"shareable"`: own private IPC namespace, with a possibility to share it with other containers - `"container:<name|id>"`: join another (shareable) container's IPC namespace - `"host"`: use the host system's IPC namespace If not specified, daemon default is used, which can either be `"private"` or `"shareable"`, depending on daemon version and configuration.
    - `Cgroup` string — Cgroup to use for the container.
    - `Links` string[] — A list of links for the container in the form `container_name:alias`.
    - `OomScoreAdj` integer — An integer value containing the score given to the container in order to tune OOM killer preferences.
    - `PidMode` string — Set the PID (Process) Namespace mode for the container. It can be either: - `"container:<name|id>"`: joins another container's PID namespace - `"host"`: use the host's PID namespace inside the container
    - `Privileged` boolean — Gives the container full access to the host.
    - `PublishAllPorts` boolean — Allocates an ephemeral host port for all of a container's exposed ports. Ports are de-allocated when the container stops and allocated when the container starts. The allocated port might be changed when restarting the container. The port is selected from the ephemeral port range that depends on the kernel. For example, on Linux the range is defined by `/proc/sys/net/ipv4/ip_local_port_range`.
    - `ReadonlyRootfs` boolean — Mount the container's root filesystem as read only.
    - `SecurityOpt` string[] — A list of string values to customize labels for MLS systems, such as SELinux.
    - `StorageOpt` object — Storage driver options for this container, in the form `{"size": "120G"}`.
    - `Tmpfs` object — A map of container directories which should be replaced by tmpfs mounts, and their corresponding mount options. For example: ``` { "/run": "rw,noexec,nosuid,size=65536k" } ```
    - `UTSMode` string — UTS namespace to use for the container.
    - `UsernsMode` string — Sets the usernamespace mode for the container when usernamespace remapping option is enabled.
    - `ShmSize` integer — Size of `/dev/shm` in bytes. If omitted, the system uses 64MB.
    - `Sysctls` object, nullable — A list of kernel parameters (sysctls) to set in the container. This field is omitted if not set.
    - `Runtime` string, nullable — Runtime to use with this container.
    - `Isolation` 'default' | 'process' | 'hyperv' | '' — Isolation technology of the container. (Windows only)
    - `MaskedPaths` string[] — The list of paths to be masked inside the container (this overrides the default set of paths).
    - `ReadonlyPaths` string[] — The list of paths to be set as read-only inside the container (this overrides the default set of paths).
  - `GraphDriver` DriverData — Information about the storage driver used to store the container's and image's filesystem.
    - `Name` string, required — Name of the storage driver.
    - `Data` object, required — Low-level storage metadata, provided as key/value pairs. This information is driver-specific, and depends on the storage-driver in use, and should be used for informational purposes only.
  - `SizeRw` integer, nullable — The size of files that have been created or changed by this container. This field is omitted by default, and only set when size is requested in the API request.
  - `SizeRootFs` integer, nullable — The total size of all files in the read-only layers from the image that the container uses. These layers can be shared between containers. This field is omitted by default, and only set when size is requested in the API request.
  - `Mounts` MountPoint[] — List of mounts used by the container.
    - `Type` 'bind' | 'volume' | 'image' | 'tmpfs' | 'npipe' | 'cluster' — The mount type: - `bind` a mount of a file or directory from the host into the container. - `volume` a docker volume with the given `Name`. - `image` a docker image - `tmpfs` a `tmpfs`. - `npipe` a named pipe from the host into the container. - `cluster` a Swarm cluster volume
    - `Name` string — Name is the name reference to the underlying data defined by `Source` e.g., the volume name.
    - `Source` string — Source location of the mount. For volumes, this contains the storage location of the volume (within `/var/lib/docker/volumes/`). For bind-mounts, and `npipe`, this contains the source (host) part of the bind-mount. For `tmpfs` mount points, this field is empty.
    - `Destination` string — Destination is the path relative to the container root (`/`) where the `Source` is mounted inside the container.
    - `Driver` string — Driver is the volume driver used to create the volume (if it is a volume).
    - `Mode` string — Mode is a comma separated list of options supplied by the user when creating the bind/volume mount. The default is platform-specific (`"z"` on Linux, empty on Windows).
    - `RW` boolean — Whether the mount is mounted writable (read-write).
    - `Propagation` string — Propagation describes how mounts are propagated from the host into the mount point, and vice-versa. Refer to the [Linux kernel documentation](https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt) for details. This field is not used on Windows.
  - `Config` ContainerConfig — Configuration for a container that is portable between hosts.
    - `Hostname` string — The hostname to use for the container, as a valid RFC 1123 hostname.
    - `Domainname` string — The domain name to use for the container.
    - `User` string — Commands run as this user inside the container. If omitted, commands run as the user specified in the image the container was started from. Can be either user-name or UID, and optional group-name or GID, separated by a colon (`<user-name|UID>[<:group-name|GID>]`).
    - `AttachStdin` boolean — Whether to attach to `stdin`.
    - `AttachStdout` boolean — Whether to attach to `stdout`.
    - `AttachStderr` boolean — Whether to attach to `stderr`.
    - `ExposedPorts` object, nullable — An object mapping ports to an empty object in the form: `{"<port>/<tcp|udp|sctp>": {}}`
    - `Tty` boolean — Attach standard streams to a TTY, including `stdin` if it is not closed.
    - `OpenStdin` boolean — Open `stdin`
    - `StdinOnce` boolean — Close `stdin` after one attached client disconnects
    - `Env` string[] — 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.
    - `Cmd` string[] — Command to run specified as a string or an array of strings.
    - `Healthcheck` HealthConfig — A test to perform to check that the container is healthy.
      - `Test` string[] — The test to perform. Possible values are: - `[]` inherit healthcheck from image or parent image - `["NONE"]` disable healthcheck - `["CMD", args...]` exec arguments directly - `["CMD-SHELL", command]` run command with system's default shell
      - `Interval` integer — The time to wait between checks in nanoseconds. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
      - `Timeout` integer — The time to wait before considering the check to have hung. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
      - `Retries` integer — The number of consecutive failures needed to consider a container as unhealthy. 0 means inherit.
      - `StartPeriod` integer — Start period for the container to initialize before starting health-retries countdown in nanoseconds. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
      - `StartInterval` integer — The time to wait between checks in nanoseconds during the start period. It should be 0 or at least 1000000 (1 ms). 0 means inherit.
    - `ArgsEscaped` boolean, nullable — Command is already escaped (Windows only)
    - `Image` string — The name (or reference) of the image to use when creating the container, or which was used when the container was created.
    - `Volumes` object — An object mapping mount point paths inside the container to empty objects.
    - `WorkingDir` string — The working directory for commands to run in.
    - `Entrypoint` string[] — 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`).
    - `NetworkDisabled` boolean, nullable — Disable networking for the container.
    - `MacAddress` string, nullable — MAC address of the container. Deprecated: this field is deprecated in API v1.44 and up. Use EndpointSettings.MacAddress instead.
    - `OnBuild` string[], nullable — `ONBUILD` metadata that were defined in the image's `Dockerfile`.
    - `Labels` object — User-defined key/value metadata.
    - `StopSignal` string, nullable — Signal to stop a container as a string or unsigned integer.
    - `StopTimeout` integer, nullable — Timeout to stop a container in seconds.
    - `Shell` string[], nullable — Shell for when `RUN`, `CMD`, and `ENTRYPOINT` uses a shell.
  - `NetworkSettings` NetworkSettings — NetworkSettings exposes the network settings in the API
    - `Bridge` string — Name of the default bridge interface when dockerd's --bridge flag is set.
    - `SandboxID` string — SandboxID uniquely represents a container's network stack.
    - `HairpinMode` boolean — Indicates if hairpin NAT should be enabled on the virtual interface. Deprecated: This field is never set and will be removed in a future release.
    - `LinkLocalIPv6Address` string — IPv6 unicast address using the link-local prefix. Deprecated: This field is never set and will be removed in a future release.
    - `LinkLocalIPv6PrefixLen` integer — Prefix length of the IPv6 unicast address. Deprecated: This field is never set and will be removed in a future release.
    - `Ports` PortMap — PortMap describes the mapping of container ports to host ports, using the container's port-number and protocol as key in the format `<port>/<protocol>`, for example, `80/udp`. If a container's port is mapped for multiple protocols, separate entries are added to the mapping table.
    - `SandboxKey` string — SandboxKey is the full path of the netns handle
    - `SecondaryIPAddresses` Address[], nullable — Deprecated: This field is never set and will be removed in a future release.
      - `Addr` string — IP address.
      - `PrefixLen` integer — Mask length of the IP address.
    - `SecondaryIPv6Addresses` Address[], nullable — Deprecated: This field is never set and will be removed in a future release.
      - `Addr` string — IP address.
      - `PrefixLen` integer — Mask length of the IP address.
    - `EndpointID` string — EndpointID uniquely represents a service endpoint in a Sandbox. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `Gateway` string — Gateway address for the default "bridge" network. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `GlobalIPv6Address` string — Global IPv6 address for the default "bridge" network. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `GlobalIPv6PrefixLen` integer — Mask length of the global IPv6 address. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `IPAddress` string — IPv4 address for the default "bridge" network. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `IPPrefixLen` integer — Mask length of the IPv4 address. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `IPv6Gateway` string — IPv6 gateway address for this network. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `MacAddress` string — MAC address for the container on the default "bridge" network. <p><br /></p> > **Deprecated**: This field is only propagated when attached to the > default "bridge" network. Use the information from the "bridge" > network inside the `Networks` map instead, which contains the same > information. This field was deprecated in Docker 1.9 and is scheduled > to be removed in Docker 17.12.0
    - `Networks` object — Information about all networks that the container is connected to.

## Other responses

- `404` — no such container
- `500` — server error

---

[API](https://skmtc.net/openshift/apis/docker-engine-api.md) · [All operations](https://skmtc.net/openshift/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openshift/docker-engine-api/versions/f56f003a4e97/schema)
