Docker Engine API
  1. System
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. System

Get data usage information

/v1.33
/v1.33
/v1.33
/v1.33
GET
/system/df
System
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.33/system/df'
Response Response Example
200 - Example 1
{
    "Containers": [
        {
            "Command": "top",
            "Created": 1472592424,
            "HostConfig": {
                "NetworkMode": "default"
            },
            "Id": "e575172ed11dc01bfce087fb27bee502db149e1a0fad7c296ad300bbff178148",
            "Image": "busybox",
            "ImageID": "sha256:2b8fd9751c4c0f5dd266fcae00707e67a2545ef34f9a29354585f93dac906749",
            "Labels": {},
            "Mounts": [],
            "Names": [
                "/top"
            ],
            "NetworkSettings": {
                "Networks": {
                    "bridge": {
                        "Aliases": null,
                        "EndpointID": "8ed5115aeaad9abb174f68dcf135b49f11daf597678315231a32ca28441dec6a",
                        "Gateway": "172.18.0.1",
                        "GlobalIPv6Address": "",
                        "GlobalIPv6PrefixLen": 0,
                        "IPAMConfig": null,
                        "IPAddress": "172.18.0.2",
                        "IPPrefixLen": 16,
                        "IPv6Gateway": "",
                        "Links": null,
                        "MacAddress": "02:42:ac:12:00:02",
                        "NetworkID": "d687bc59335f0e5c9ee8193e5612e8aee000c8c62ea170cfb99c098f95899d92"
                    }
                }
            },
            "Ports": [],
            "SizeRootFs": 1092588,
            "State": "exited",
            "Status": "Exited (0) 56 minutes ago"
        }
    ],
    "Images": [
        {
            "Containers": 1,
            "Created": 1466724217,
            "Id": "sha256:2b8fd9751c4c0f5dd266fcae00707e67a2545ef34f9a29354585f93dac906749",
            "Labels": {},
            "ParentId": "",
            "RepoDigests": [
                "busybox@sha256:a59906e33509d14c036c8678d687bd4eec81ed7c4b8ce907b888c607f6a1e0e6"
            ],
            "RepoTags": [
                "busybox:latest"
            ],
            "SharedSize": 0,
            "Size": 1092588,
            "VirtualSize": 1092588
        }
    ],
    "LayersSize": 1092588,
    "Volumes": [
        {
            "Driver": "local",
            "Labels": null,
            "Mountpoint": "/var/lib/docker/volumes/my-volume/_data",
            "Name": "my-volume",
            "Options": null,
            "Scope": "local",
            "UsageData": {
                "RefCount": 2,
                "Size": 10920104
            }
        }
    ]
}

Request

None

Responses

🟢200no error
application/json
Body
Containers
array[array (ContainerSummary) {1}] 
optional
object 
optional
Images
array[object (ImageSummary) {10}] 
optional
Containers
integer 
required
Created
integer 
required
Id
string 
required
Labels
object 
required
ParentId
string 
required
RepoDigests
array[string]
required
RepoTags
array[string]
required
SharedSize
integer 
required
Size
integer 
required
VirtualSize
integer 
required
LayersSize
integer <int64>
optional
Volumes
array[object (Volume) {9}] 
optional
CreatedAt
string <dateTime>
optional
Date/Time the volume was created.
Driver
string 
required
Name of the volume driver used by the volume.
Labels
object 
required
User-defined key/value metadata.
Mountpoint
string 
required
Mount path of the volume on the host.
Name
string 
required
Name of the volume.
Options
object 
required
The driver specific options used when creating the volume.
Scope
enum<string> 
required
The level at which the volume exists. Either global for cluster-wide, or local for machine level.
Allowed values:
localglobal
Default:
local
Status
object 
optional
Low-level details about the volume, provided by the volume driver.
Details are returned as a map with key/value pairs:
{"key":"value","key2":"value2"}.
The Status field is optional, and is omitted if the volume driver
does not support this feature.
UsageData
object  | null 
optional
Usage details about the volume. This information is used by the
GET /system/df endpoint, and omitted in other endpoints.
🔴500server error
Modified at 2022-09-10 17:56:06
Previous
Get system information
Next
Get version
Built with