Victoria BialasandTibor Vass
d3b7a2779e
fixing links after moving surfacing tutorials fixing more links for the newly located tutorials Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
2.4 KiB
volume ls
Usage: docker volume ls [OPTIONS]
List volumes
-f, --filter=[] Filter output based on these conditions:
- dangling=<boolean> a volume if referenced or not
- driver=<string> a volume's driver name
- name=<string> a volume's name
--help Print usage
-q, --quiet Only display volume names
Lists all the volumes Docker knows about. You can filter using the -f or --filter flag. Refer to the filtering section for more information about available filter options.
Example output:
$ docker volume create --name rosemary
rosemary
$docker volume create --name tyler
tyler
$ docker volume ls
DRIVER VOLUME NAME
local rosemary
local tyler
Filtering
The filtering flag (-f or --filter) format is of "key=value". If there is more
than one filter, then pass multiple flags (e.g., --filter "foo=bar" --filter "bif=baz")
The currently supported filters are:
- dangling (boolean - true or false, 0 or 1)
- driver (a volume driver's name)
- name (a volume's name)
dangling
The dangling filter matches on all volumes not referenced by any containers
$ docker run -d -v tyler:/tmpwork busybox
f86a7dd02898067079c99ceacd810149060a70528eff3754d0b0f1a93bd0af18
$ docker volume ls -f dangling=true
DRIVER VOLUME NAME
local rosemary
driver
The driver filter matches on all or part of a volume's driver name.
The following filter matches all volumes with a driver name containing the local string.
$ docker volume ls -f driver=local
DRIVER VOLUME NAME
local rosemary
local tyler
name
The name filter matches on all or part of a volume's name.
The following filter matches all volumes with a name containing the rose string.
$ docker volume ls -f name=rose
DRIVER VOLUME NAME
local rosemary