Delete unused volumes Run in API Explorer

POST /volumes/prune

Query parameters

  • filters string

    Filters to process on the prune list, encoded as JSON (a map[string][]string).

    Available filters:

    • label (label=<key>, label=<key>=<value>, label!=<key>, or label!=<key>=<value>) Prune volumes with (or without, in case label!=... is used) the specified labels.
    • all (all=true) - Consider all (local) volumes for pruning and not just anonymous volumes.

Responses

  • 200 application/json

    No error

    Hide response attributes Show response attributes object
    • VolumesDeleted array[string]

      Volumes that were deleted

    • SpaceReclaimed integer(int64)

      Disk space reclaimed in bytes
  • 500 application/json

    Server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
POST /volumes/prune 
curl \
 --request POST 'http://api.example.com/v1.49/volumes/prune'
Response examples (200) 
{
  "VolumesDeleted": [
    "string"
  ],
  "SpaceReclaimed": 42
}
Response examples (500) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}