@@ -1 +1 @@

-1.11.0-dev

+1.12.0-dev

@@ -18,7 +18,7 @@ import (

 // Common constants for daemon and client.

 const (

 	// Version of Current REST API

-	DefaultVersion version.Version = "1.23"

+	DefaultVersion version.Version = "1.24"

 	// MinVersion represents Minimum REST API version supported

 	MinVersion version.Version = "1.12"

@@ -35,14 +35,15 @@ If you have bound the Docker daemon to a different socket path or TCP

 port, you would reference that in your cURL rather than the

 default.

-The current version of the API is v1.23 which means calling `/info` is the same

-as calling `/v1.23/info`. To call an older version of the API use

-`/v1.22/info`.

+The current version of the API is v1.24 which means calling `/info` is the same

+as calling `/v1.24/info`. To call an older version of the API use

+`/v1.23/info`.

 Use the table below to find the API version for a Docker version:

 Docker version  | API version                        | Changes

 ----------------|------------------------------------|------------------------------------------------------

+1.12.x          | [1.24](docker_remote_api_v1.24.md) | [API changes](docker_remote_api.md#v1-24-api-changes)

 1.11.x          | [1.23](docker_remote_api_v1.23.md) | [API changes](docker_remote_api.md#v1-23-api-changes)

 1.10.x          | [1.22](docker_remote_api_v1.22.md) | [API changes](docker_remote_api.md#v1-22-api-changes)

 1.9.x           | [1.21](docker_remote_api_v1.21.md) | [API changes](docker_remote_api.md#v1-21-api-changes)

@@ -111,6 +112,10 @@ Running `docker rmi` emits an **untag** event when removing an image name.  The

 This section lists each version from latest to oldest.  Each listing includes a link to the full documentation set and the changes relevant in that release.

+### v1.24 API changes

+

+[Docker Remote API v1.24](docker_remote_api_v1.24.md) documentation

+

 ### v1.23 API changes

 [Docker Remote API v1.23](docker_remote_api_v1.23.md) documentation

new file mode 100644

@@ -0,0 +1,3272 @@

+<!--[metadata]>

+title = "Remote API v1.24"

+description = "API Documentation for Docker"

+keywords = ["API, Docker, rcli, REST,  documentation"]

+[menu.main]

+parent="engine_remoteapi"

+weight=-4

+<![end-metadata]-->

+

+# Docker Remote API v1.24

+

+## 1. Brief introduction

+

+ - The Remote API has replaced `rcli`.

+ - The daemon listens on `unix:///var/run/docker.sock` but you can

+   [Bind Docker to another host/port or a Unix socket](../../quickstart.md#bind-docker-to-another-host-port-or-a-unix-socket).

+ - The API tends to be REST. However, for some complex commands, like `attach`

+   or `pull`, the HTTP connection is hijacked to transport `stdout`,

+   `stdin` and `stderr`.

+ - When the client API version is newer than the daemon's, these calls return an HTTP

+   `400 Bad Request` error message.

+

+# 2. Endpoints

+

+## 2.1 Containers

+

+### List containers

+

+`GET /containers/json`

+

+List containers

+

+**Example request**:

+

+    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    [

+         {

+                 "Id": "8dfafdbc3a40",

+                 "Names":["/boring_feynman"],

+                 "Image": "ubuntu:latest",

+                 "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",

+                 "Command": "echo 1",

+                 "Created": 1367854155,

+                 "State": "Exited",

+                 "Status": "Exit 0",

+                 "Ports": [{"PrivatePort": 2222, "PublicPort": 3333, "Type": "tcp"}],

+                 "Labels": {

+                         "com.example.vendor": "Acme",

+                         "com.example.license": "GPL",

+                         "com.example.version": "1.0"

+                 },

+                 "SizeRw": 12288,

+                 "SizeRootFs": 0,

+                 "HostConfig": {

+                         "NetworkMode": "default"

+                 },

+                 "NetworkSettings": {

+                         "Networks": {

+                                 "bridge": {

+                                          "IPAMConfig": null,

+                                          "Links": null,

+                                          "Aliases": null,

+                                          "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",

+                                          "EndpointID": "2cdc4edb1ded3631c81f57966563e5c8525b81121bb3706a9a9a3ae102711f3f",

+                                          "Gateway": "172.17.0.1",

+                                          "IPAddress": "172.17.0.2",

+                                          "IPPrefixLen": 16,

+                                          "IPv6Gateway": "",

+                                          "GlobalIPv6Address": "",

+                                          "GlobalIPv6PrefixLen": 0,

+                                          "MacAddress": "02:42:ac:11:00:02"

+                                  }

+                         }

+                 },

+                 "Mounts": [

+                         {

+                                  "Name": "fac362...80535",

+                                  "Source": "/data",

+                                  "Destination": "/data",

+                                  "Driver": "local",

+                                  "Mode": "ro,Z",

+                                  "RW": false,

+                                  "Propagation": ""

+                         }

+                 ]

+         },

+         {

+                 "Id": "9cd87474be90",

+                 "Names":["/coolName"],

+                 "Image": "ubuntu:latest",

+                 "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",

+                 "Command": "echo 222222",

+                 "Created": 1367854155,

+                 "State": "Exited",

+                 "Status": "Exit 0",

+                 "Ports": [],

+                 "Labels": {},

+                 "SizeRw": 12288,

+                 "SizeRootFs": 0,

+                 "HostConfig": {

+                         "NetworkMode": "default"

+                 },

+                 "NetworkSettings": {

+                         "Networks": {

+                                 "bridge": {

+                                          "IPAMConfig": null,

+                                          "Links": null,

+                                          "Aliases": null,

+                                          "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",

+                                          "EndpointID": "88eaed7b37b38c2a3f0c4bc796494fdf51b270c2d22656412a2ca5d559a64d7a",

+                                          "Gateway": "172.17.0.1",

+                                          "IPAddress": "172.17.0.8",

+                                          "IPPrefixLen": 16,

+                                          "IPv6Gateway": "",

+                                          "GlobalIPv6Address": "",

+                                          "GlobalIPv6PrefixLen": 0,

+                                          "MacAddress": "02:42:ac:11:00:08"

+                                  }

+                         }

+                 },

+                 "Mounts": []

+         },

+         {

+                 "Id": "3176a2479c92",

+                 "Names":["/sleepy_dog"],

+                 "Image": "ubuntu:latest",

+                 "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",

+                 "Command": "echo 3333333333333333",

+                 "Created": 1367854154,

+                 "State": "Exited",

+                 "Status": "Exit 0",

+                 "Ports":[],

+                 "Labels": {},

+                 "SizeRw":12288,

+                 "SizeRootFs":0,

+                 "HostConfig": {

+                         "NetworkMode": "default"

+                 },

+                 "NetworkSettings": {

+                         "Networks": {

+                                 "bridge": {

+                                          "IPAMConfig": null,

+                                          "Links": null,

+                                          "Aliases": null,

+                                          "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",

+                                          "EndpointID": "8b27c041c30326d59cd6e6f510d4f8d1d570a228466f956edf7815508f78e30d",

+                                          "Gateway": "172.17.0.1",

+                                          "IPAddress": "172.17.0.6",

+                                          "IPPrefixLen": 16,

+                                          "IPv6Gateway": "",

+                                          "GlobalIPv6Address": "",

+                                          "GlobalIPv6PrefixLen": 0,

+                                          "MacAddress": "02:42:ac:11:00:06"

+                                  }

+                         }

+                 },

+                 "Mounts": []

+         },

+         {

+                 "Id": "4cb07b47f9fb",

+                 "Names":["/running_cat"],

+                 "Image": "ubuntu:latest",

+                 "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",

+                 "Command": "echo 444444444444444444444444444444444",

+                 "Created": 1367854152,

+                 "State": "Exited",

+                 "Status": "Exit 0",

+                 "Ports": [],

+                 "Labels": {},

+                 "SizeRw": 12288,

+                 "SizeRootFs": 0,

+                 "HostConfig": {

+                         "NetworkMode": "default"

+                 },

+                 "NetworkSettings": {

+                         "Networks": {

+                                 "bridge": {

+                                          "IPAMConfig": null,

+                                          "Links": null,

+                                          "Aliases": null,

+                                          "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",

+                                          "EndpointID": "d91c7b2f0644403d7ef3095985ea0e2370325cd2332ff3a3225c4247328e66e9",

+                                          "Gateway": "172.17.0.1",

+                                          "IPAddress": "172.17.0.5",

+                                          "IPPrefixLen": 16,

+                                          "IPv6Gateway": "",

+                                          "GlobalIPv6Address": "",

+                                          "GlobalIPv6PrefixLen": 0,

+                                          "MacAddress": "02:42:ac:11:00:05"

+                                  }

+                         }

+                 },

+                 "Mounts": []

+         }

+    ]

+

+Query Parameters:

+

+-   **all** – 1/True/true or 0/False/false, Show all containers.

+        Only running containers are shown by default (i.e., this defaults to false)

+-   **limit** – Show `limit` last created

+        containers, include non-running ones.

+-   **since** – Show only containers created since Id, include

+        non-running ones.

+-   **before** – Show only containers created before Id, include

+        non-running ones.

+-   **size** – 1/True/true or 0/False/false, Show the containers

+        sizes

+-   **filters** - a JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters:

+  -   `exited=<int>`; -- containers with exit code of  `<int>` ;

+  -   `status=`(`created`|`restarting`|`running`|`paused`|`exited`|`dead`)

+  -   `label=key` or `label="key=value"` of a container label

+  -   `isolation=`(`default`|`process`|`hyperv`)   (Windows daemon only)

+  -   `ancestor`=(`<image-name>[:<tag>]`,  `<image id>` or `<image@digest>`)

+  -   `before`=(`<container id>` or `<container name>`)

+  -   `since`=(`<container id>` or `<container name>`)

+  -   `volume`=(`<volume name>` or `<mount point destination>`)

+

+Status Codes:

+

+-   **200** – no error

+-   **400** – bad parameter

+-   **500** – server error

+

+### Create a container

+

+`POST /containers/create`

+

+Create a container

+

+**Example request**:

+

+    POST /containers/create HTTP/1.1

+    Content-Type: application/json

+

+    {

+           "Hostname": "",

+           "Domainname": "",

+           "User": "",

+           "AttachStdin": false,

+           "AttachStdout": true,

+           "AttachStderr": true,

+           "Tty": false,

+           "OpenStdin": false,

+           "StdinOnce": false,

+           "Env": [

+                   "FOO=bar",

+                   "BAZ=quux"

+           ],

+           "Cmd": [

+                   "date"

+           ],

+           "Entrypoint": "",

+           "Image": "ubuntu",

+           "Labels": {

+                   "com.example.vendor": "Acme",

+                   "com.example.license": "GPL",

+                   "com.example.version": "1.0"

+           },

+           "Mounts": [

+             {

+               "Name": "fac362...80535",

+               "Source": "/data",

+               "Destination": "/data",

+               "Driver": "local",

+               "Mode": "ro,Z",

+               "RW": false,

+               "Propagation": ""

+             }

+           ],

+           "Volumes": {

+             "/volumes/data": {}

+           }

+           "WorkingDir": "",

+           "NetworkDisabled": false,

+           "MacAddress": "12:34:56:78:9a:bc",

+           "ExposedPorts": {

+                   "22/tcp": {}

+           },

+           "StopSignal": "SIGTERM",

+           "HostConfig": {

+             "Binds": ["/tmp:/tmp"],

+             "Links": ["redis3:redis"],

+             "Memory": 0,

+             "MemorySwap": 0,

+             "MemoryReservation": 0,

+             "KernelMemory": 0,

+             "CpuShares": 512,

+             "CpuPeriod": 100000,

+             "CpuQuota": 50000,

+             "CpusetCpus": "0,1",

+             "CpusetMems": "0,1",

+             "BlkioWeight": 300,

+             "BlkioWeightDevice": [{}],

+             "BlkioDeviceReadBps": [{}],

+             "BlkioDeviceReadIOps": [{}],

+             "BlkioDeviceWriteBps": [{}],

+             "BlkioDeviceWriteIOps": [{}],

+             "MemorySwappiness": 60,

+             "OomKillDisable": false,

+             "OomScoreAdj": 500,

+             "PortBindings": { "22/tcp": [{ "HostPort": "11022" }] },

+             "PublishAllPorts": false,

+             "Privileged": false,

+             "ReadonlyRootfs": false,

+             "Dns": ["8.8.8.8"],

+             "DnsOptions": [""],

+             "DnsSearch": [""],

+             "ExtraHosts": null,

+             "VolumesFrom": ["parent", "other:ro"],

+             "CapAdd": ["NET_ADMIN"],

+             "CapDrop": ["MKNOD"],

+             "GroupAdd": ["newgroup"],

+             "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 },

+             "NetworkMode": "bridge",

+             "Devices": [],

+             "Ulimits": [{}],

+             "LogConfig": { "Type": "json-file", "Config": {} },

+             "SecurityOpt": [""],

+             "CgroupParent": "",

+             "VolumeDriver": "",

+             "ShmSize": 67108864

+          }

+      }

+

+**Example response**:

+

+      HTTP/1.1 201 Created

+      Content-Type: application/json

+

+      {

+           "Id":"e90e34656806",

+           "Warnings":[]

+      }

+

+Json Parameters:

+

+-   **Hostname** - A string value containing the hostname to use for the

+      container.

+-   **Domainname** - A string value containing the domain name to use

+      for the container.

+-   **User** - A string value specifying the user inside the container.

+-   **Memory** - Memory limit in bytes.

+-   **MemorySwap** - Total memory limit (memory + swap); set `-1` to enable unlimited swap.

+      You must use this with `memory` and make the swap value larger than `memory`.

+-   **MemoryReservation** - Memory soft limit in bytes.

+-   **KernelMemory** - Kernel memory limit in bytes.

+-   **CpuShares** - An integer value containing the container's CPU Shares

+      (ie. the relative weight vs other containers).

+-   **CpuPeriod** - The length of a CPU period in microseconds.

+-   **CpuQuota** - Microseconds of CPU time that the container can get in a CPU period.

+-   **Cpuset** - Deprecated please don't use. Use `CpusetCpus` instead.

+-   **CpusetCpus** - String value containing the `cgroups CpusetCpus` to use.

+-   **CpusetMems** - Memory nodes (MEMs) in which to allow execution (0-3, 0,1). Only effective on NUMA systems.

+-   **BlkioWeight** - Block IO weight (relative weight) accepts a weight value between 10 and 1000.

+-   **BlkioWeightDevice** - Block IO weight (relative device weight) in the form of:        `"BlkioWeightDevice": [{"Path": "device_path", "Weight": weight}]`

+-   **BlkioDeviceReadBps** - Limit read rate (bytes per second) from a device in the form of:	`"BlkioDeviceReadBps": [{"Path": "device_path", "Rate": rate}]`, for example:

+	`"BlkioDeviceReadBps": [{"Path": "/dev/sda", "Rate": "1024"}]"`

+-   **BlkioDeviceWriteBps** - Limit write rate (bytes per second) to a device in the form of:	`"BlkioDeviceWriteBps": [{"Path": "device_path", "Rate": rate}]`, for example:

+	`"BlkioDeviceWriteBps": [{"Path": "/dev/sda", "Rate": "1024"}]"`

+-   **BlkioDeviceReadIOps** - Limit read rate (IO per second) from a device in the form of:	`"BlkioDeviceReadIOps": [{"Path": "device_path", "Rate": rate}]`, for example:

+	`"BlkioDeviceReadIOps": [{"Path": "/dev/sda", "Rate": "1000"}]`

+-   **BlkioDeviceWiiteIOps** - Limit write rate (IO per second) to a device in the form of:	`"BlkioDeviceWriteIOps": [{"Path": "device_path", "Rate": rate}]`, for example:

+	`"BlkioDeviceWriteIOps": [{"Path": "/dev/sda", "Rate": "1000"}]`

+-   **MemorySwappiness** - Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100.

+-   **OomKillDisable** - Boolean value, whether to disable OOM Killer for the container or not.

+-   **OomScoreAdj** - An integer value containing the score given to the container in order to tune OOM killer preferences.

+-   **PidsLimit** - Tune a container's pids limit. Set -1 for unlimited.

+-   **AttachStdin** - Boolean value, attaches to `stdin`.

+-   **AttachStdout** - Boolean value, attaches to `stdout`.

+-   **AttachStderr** - Boolean value, attaches to `stderr`.

+-   **Tty** - Boolean value, Attach standard streams to a `tty`, including `stdin` if it is not closed.

+-   **OpenStdin** - Boolean value, opens stdin,

+-   **StdinOnce** - Boolean value, close `stdin` after the 1 attached client disconnects.

+-   **Env** - A list of environment variables in the form of `["VAR=value"[,"VAR2=value2"]]`

+-   **Labels** - Adds a map of labels to a container. To specify a map: `{"key":"value"[,"key2":"value2"]}`

+-   **Cmd** - Command to run specified as a string or an array of strings.

+-   **Entrypoint** - Set the entry point for the container as a string or an array

+      of strings.

+-   **Image** - A string specifying the image name to use for the container.

+-   **Mounts** - An array of mount points in the container.

+-   **WorkingDir** - A string specifying the working directory for commands to

+      run in.

+-   **NetworkDisabled** - Boolean value, when true disables networking for the

+      container

+-   **ExposedPorts** - An object mapping ports to an empty object in the form of:

+      `"ExposedPorts": { "<port>/<tcp|udp>: {}" }`

+-   **StopSignal** - Signal to stop a container as a string or unsigned integer. `SIGTERM` by default.

+-   **HostConfig**

+    -   **Binds** – A list of volume bindings for this container. Each volume binding is a string in one of these forms:

+           + `host_path:container_path` to bind-mount a host path into the container

+           + `host_path:container_path:ro` to make the bind-mount read-only inside the container.

+           + `volume_name:container_path` to bind-mount a volume managed by a volume plugin into the container.

+           + `volume_name:container_path:ro` to make the bind mount read-only inside the container.

+    -   **Links** - A list of links for the container. Each link entry should be

+          in the form of `container_name:alias`.

+    -   **PortBindings** - A map of exposed container ports and the host port they

+          should map to. A JSON object in the form

+          `{ <port>/<protocol>: [{ "HostPort": "<port>" }] }`

+          Take note that `port` is specified as a string and not an integer value.

+    -   **PublishAllPorts** - Allocates a random host port for all of a container's

+          exposed ports. Specified as a boolean value.

+    -   **Privileged** - Gives the container full access to the host. Specified as

+          a boolean value.

+    -   **ReadonlyRootfs** - Mount the container's root filesystem as read only.

+          Specified as a boolean value.

+    -   **Dns** - A list of DNS servers for the container to use.

+    -   **DnsOptions** - A list of DNS options

+    -   **DnsSearch** - A list of DNS search domains

+    -   **ExtraHosts** - A list of hostnames/IP mappings to add to the

+        container's `/etc/hosts` file. Specified in the form `["hostname:IP"]`.

+    -   **VolumesFrom** - A list of volumes to inherit from another container.

+          Specified in the form `<container name>[:<ro|rw>]`

+    -   **CapAdd** - A list of kernel capabilities to add to the container.

+    -   **Capdrop** - A list of kernel capabilities to drop from the container.

+    -   **GroupAdd** - A list of additional groups that the container process will run as

+    -   **RestartPolicy** – The behavior to apply when the container exits.  The

+            value is an object with a `Name` property of either `"always"` to

+            always restart, `"unless-stopped"` to restart always except when

+            user has manually stopped the container or `"on-failure"` to restart only when the container

+            exit code is non-zero.  If `on-failure` is used, `MaximumRetryCount`

+            controls the number of times to retry before giving up.

+            The default is not to restart. (optional)

+            An ever increasing delay (double the previous delay, starting at 100mS)

+            is added before each restart to prevent flooding the server.

+    -   **UsernsMode**  - Sets the usernamespace mode for the container when usernamespace remapping option is enabled.

+           supported values are: `host`.

+    -   **NetworkMode** - Sets the networking mode for the 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.

+    -   **Devices** - A list of devices to add to the container specified as a JSON object in the

+      form

+          `{ "PathOnHost": "/dev/deviceName", "PathInContainer": "/dev/deviceName", "CgroupPermissions": "mrw"}`

+    -   **Ulimits** - A list of ulimits to set in the container, specified as

+          `{ "Name": <name>, "Soft": <soft limit>, "Hard": <hard limit> }`, for example:

+          `Ulimits: { "Name": "nofile", "Soft": 1024, "Hard": 2048 }`

+    -   **SecurityOpt**: A list of string values to customize labels for MLS

+        systems, such as SELinux.

+    -   **LogConfig** - Log configuration for the container, specified as a JSON object in the form

+          `{ "Type": "<driver_name>", "Config": {"key1": "val1"}}`.

+          Available types: `json-file`, `syslog`, `journald`, `gelf`, `fluentd`, `awslogs`, `splunk`, `etwlogs`, `none`.

+          `json-file` logging driver.

+    -   **CgroupParent** - 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.

+    -   **VolumeDriver** - Driver that this container users to mount volumes.

+    -   **ShmSize** - Size of `/dev/shm` in bytes. The size must be greater than 0.  If omitted the system uses 64MB.

+

+Query Parameters:

+

+-   **name** – Assign the specified name to the container. Must

+    match `/?[a-zA-Z0-9_-]+`.

+

+Status Codes:

+

+-   **201** – no error

+-   **404** – no such container

+-   **406** – impossible to attach (container not running)

+-   **500** – server error

+

+### Inspect a container

+

+`GET /containers/(id or name)/json`

+

+Return low-level information on the container `id`

+

+

+**Example request**:

+

+      GET /containers/4fa6e0f0c678/json HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    {

+		"AppArmorProfile": "",

+		"Args": [

+			"-c",

+			"exit 9"

+		],

+		"Config": {

+			"AttachStderr": true,

+			"AttachStdin": false,

+			"AttachStdout": true,

+			"Cmd": [

+				"/bin/sh",

+				"-c",

+				"exit 9"

+			],

+			"Domainname": "",

+			"Entrypoint": null,

+			"Env": [

+				"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

+			],

+			"ExposedPorts": null,

+			"Hostname": "ba033ac44011",

+			"Image": "ubuntu",

+			"Labels": {

+				"com.example.vendor": "Acme",

+				"com.example.license": "GPL",

+				"com.example.version": "1.0"

+			},

+			"MacAddress": "",

+			"NetworkDisabled": false,

+			"OnBuild": null,

+			"OpenStdin": false,

+			"StdinOnce": false,

+			"Tty": false,

+			"User": "",

+			"Volumes": {

+                          "/volumes/data": {}

+                        },

+			"WorkingDir": "",

+			"StopSignal": "SIGTERM"

+		},

+		"Created": "2015-01-06T15:47:31.485331387Z",

+		"Driver": "devicemapper",

+		"ExecDriver": "native-0.2",

+		"ExecIDs": null,

+		"HostConfig": {

+			"Binds": null,

+			"BlkioWeight": 0,

+			"BlkioWeightDevice": [{}],

+			"BlkioDeviceReadBps": [{}],

+			"BlkioDeviceWriteBps": [{}],

+			"BlkioDeviceReadIOps": [{}],

+			"BlkioDeviceWriteIOps": [{}],

+			"CapAdd": null,

+			"CapDrop": null,

+			"ContainerIDFile": "",

+			"CpusetCpus": "",

+			"CpusetMems": "",

+			"CpuShares": 0,

+			"CpuPeriod": 100000,

+			"Devices": [],

+			"Dns": null,

+			"DnsOptions": null,

+			"DnsSearch": null,

+			"ExtraHosts": null,

+			"IpcMode": "",

+			"Links": null,

+			"LxcConf": [],

+			"Memory": 0,

+			"MemorySwap": 0,

+			"MemoryReservation": 0,

+			"KernelMemory": 0,

+			"OomKillDisable": false,

+			"OomScoreAdj": 500,

+			"NetworkMode": "bridge",

+			"PortBindings": {},

+			"Privileged": false,

+			"ReadonlyRootfs": false,

+			"PublishAllPorts": false,

+			"RestartPolicy": {

+				"MaximumRetryCount": 2,

+				"Name": "on-failure"

+			},

+			"LogConfig": {

+				"Config": null,

+				"Type": "json-file"

+			},

+			"SecurityOpt": null,

+			"VolumesFrom": null,

+			"Ulimits": [{}],

+			"VolumeDriver": "",

+			"ShmSize": 67108864

+		},

+		"HostnamePath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hostname",

+		"HostsPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/hosts",

+		"LogPath": "/var/lib/docker/containers/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b/1eb5fabf5a03807136561b3c00adcd2992b535d624d5e18b6cdc6a6844d9767b-json.log",

+		"Id": "ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39",

+		"Image": "04c5d3b7b0656168630d3ba35d8889bd0e9caafcaeb3004d2bfbc47e7c5d35d2",

+		"MountLabel": "",

+		"Name": "/boring_euclid",

+		"NetworkSettings": {

+			"Bridge": "",

+			"SandboxID": "",

+			"HairpinMode": false,

+			"LinkLocalIPv6Address": "",

+			"LinkLocalIPv6PrefixLen": 0,

+			"Ports": null,

+			"SandboxKey": "",

+			"SecondaryIPAddresses": null,

+			"SecondaryIPv6Addresses": null,

+			"EndpointID": "",

+			"Gateway": "",

+			"GlobalIPv6Address": "",

+			"GlobalIPv6PrefixLen": 0,

+			"IPAddress": "",

+			"IPPrefixLen": 0,

+			"IPv6Gateway": "",

+			"MacAddress": "",

+			"Networks": {

+				"bridge": {

+					"NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",

+					"EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",

+					"Gateway": "172.17.0.1",

+					"IPAddress": "172.17.0.2",

+					"IPPrefixLen": 16,

+					"IPv6Gateway": "",

+					"GlobalIPv6Address": "",

+					"GlobalIPv6PrefixLen": 0,

+					"MacAddress": "02:42:ac:12:00:02"

+				}

+			}

+		},

+		"Path": "/bin/sh",

+		"ProcessLabel": "",

+		"ResolvConfPath": "/var/lib/docker/containers/ba033ac4401106a3b513bc9d639eee123ad78ca3616b921167cd74b20e25ed39/resolv.conf",

+		"RestartCount": 1,

+		"State": {

+			"Error": "",

+			"ExitCode": 9,

+			"FinishedAt": "2015-01-06T15:47:32.080254511Z",

+			"OOMKilled": false,

+			"Dead": false,

+			"Paused": false,

+			"Pid": 0,

+			"Restarting": false,

+			"Running": true,

+			"StartedAt": "2015-01-06T15:47:32.072697474Z",

+			"Status": "running"

+		},

+		"Mounts": [

+			{

+				"Name": "fac362...80535",

+				"Source": "/data",

+				"Destination": "/data",

+				"Driver": "local",

+				"Mode": "ro,Z",

+				"RW": false,

+				"Propagation": ""

+			}

+		]

+	}

+

+**Example request, with size information**:

+

+    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1

+

+**Example response, with size information**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    {

+    ....

+    "SizeRw": 0,

+    "SizeRootFs": 972,

+    ....

+    }

+

+Query Parameters:

+

+-   **size** – 1/True/true or 0/False/false, return container size information. Default is `false`.

+

+Status Codes:

+

+-   **200** – no error

+-   **404** – no such container

+-   **500** – server error

+

+### List processes running inside a container

+

+`GET /containers/(id or name)/top`

+

+List processes running inside the container `id`. On Unix systems this

+is done by running the `ps` command. This endpoint is not

+supported on Windows.

+

+**Example request**:

+

+    GET /containers/4fa6e0f0c678/top HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    {

+       "Titles" : [

+         "UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"

+       ],

+       "Processes" : [

+         [

+           "root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"

+         ],

+         [

+           "root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"

+         ]

+       ]

+    }

+

+**Example request**:

+

+    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    {

+      "Titles" : [

+        "USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"

+      ]

+      "Processes" : [

+        [

+          "root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"

+        ],

+        [

+          "root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"

+        ]

+      ],

+    }

+

+Query Parameters:

+

+-   **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`

+

+Status Codes:

+

+-   **200** – no error

+-   **404** – no such container

+-   **500** – server error

+

+### Get container logs

+

+`GET /containers/(id or name)/logs`

+

+Get `stdout` and `stderr` logs from the container ``id``

+

+> **Note**:

+> This endpoint works only for containers with the `json-file` or `journald` logging drivers.

+

+**Example request**:

+

+     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1

+

+**Example response**:

+

+     HTTP/1.1 101 UPGRADED

+     Content-Type: application/vnd.docker.raw-stream

+     Connection: Upgrade

+     Upgrade: tcp

+

+     {{ STREAM }}

+

+Query Parameters:

+

+-   **follow** – 1/True/true or 0/False/false, return stream. Default `false`.

+-   **stdout** – 1/True/true or 0/False/false, show `stdout` log. Default `false`.

+-   **stderr** – 1/True/true or 0/False/false, show `stderr` log. Default `false`.

+-   **since** – UNIX timestamp (integer) to filter logs. Specifying a timestamp

+    will only output log-entries since that timestamp. Default: 0 (unfiltered)

+-   **timestamps** – 1/True/true or 0/False/false, print timestamps for

+        every log line. Default `false`.

+-   **tail** – Output specified number of lines at the end of logs: `all` or `<number>`. Default all.

+

+Status Codes:

+

+-   **101** – no error, hints proxy about hijacking

+-   **200** – no error, no upgrade header found

+-   **404** – no such container

+-   **500** – server error

+

+### Inspect changes on a container's filesystem

+

+`GET /containers/(id or name)/changes`

+

+Inspect changes on container `id`'s filesystem

+

+**Example request**:

+

+    GET /containers/4fa6e0f0c678/changes HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/json

+

+    [

+         {

+                 "Path": "/dev",

+                 "Kind": 0

+         },

+         {

+                 "Path": "/dev/kmsg",

+                 "Kind": 1

+         },

+         {

+                 "Path": "/test",

+                 "Kind": 1

+         }

+    ]

+

+Values for `Kind`:

+

+- `0`: Modify

+- `1`: Add

+- `2`: Delete

+

+Status Codes:

+

+-   **200** – no error

+-   **404** – no such container

+-   **500** – server error

+

+### Export a container

+

+`GET /containers/(id or name)/export`

+

+Export the contents of container `id`

+

+**Example request**:

+

+    GET /containers/4fa6e0f0c678/export HTTP/1.1

+

+**Example response**:

+

+    HTTP/1.1 200 OK

+    Content-Type: application/octet-stream

+

+    {{ TAR STREAM }}

+

+Status Codes:

+

+-   **200** – no error

+-   **404** – no such container