描述

列表卷

用法

docker volume ls [OPTIONS]

备选方案

父命令

相关命令

扩展描述

列出Docker已知的所有卷。您可以使用-f或--filter标志进行过滤。有关可用过滤器选项的更多信息，请参阅过滤部分。

实例

创建卷

$ docker volume create rosemary

rosemary

$ docker volume create tyler

tyler

$ docker volume ls

DRIVER              VOLUME NAME
local               rosemary
local               tyler

过滤

过滤标志 (-f 或 --filter)格式为“key=value”。如果有多个筛选器，则传递多个标志(例如, --filter "foo=bar" --filter "bif=baz")

目前支持的过滤器是：

• 挂起(布尔 - 对或错, 0或1)

• 驱动程序（卷驱动器的名称）

• 标签 (label=<key> 或 label=<key>=<value>)

• 名称（一个卷的名称）

挂起

大dangling筛选所有未被任何容器引用的卷的匹配。

$ docker run -d  -v tyler:/tmpwork  busybox

f86a7dd02898067079c99ceacd810149060a70528eff3754d0b0f1a93bd0af18
$ docker volume ls -f dangling=trueDRIVER              VOLUME NAME
local               rosemary

驱动

大driver过滤器根据它们的驱动程序匹配卷。

下面的示例匹配用local 驱动：

$ docker volume ls -f driver=local

DRIVER              VOLUME NAME
local               rosemary
local               tyler

标签

大label过滤器根据存在的值匹配卷。label一个人还是一个人label还有一个价值。

首先，让我们创建一些卷来说明这一点；

$ docker volume create the-doctor --label is-timelord=yes

the-doctor
$ docker volume create daleks --label is-timelord=no

daleks

下面的示例筛选器将卷与is-timelord标签，不管它的价值。

$ docker volume ls --filter label=is-timelord

DRIVER              VOLUME NAME
local               daleks
local               the-doctor

如上面的示例所示，这两个卷都有is-timelord=yes，和is-timelord=no都被归还了。

两种过滤key和value产生预期的结果：

$ docker volume ls --filter label=is-timelord=yes

DRIVER              VOLUME NAME
local               the-doctor

指定多个标签筛选器会产生“和”搜索；所有条件都应满足；

$ docker volume ls --filter label=is-timelord=yes --filter label=is-timelord=no

DRIVER              VOLUME NAME

名称

大name筛选器与卷的全部或部分名称匹配。

下面的筛选器匹配所有卷的名称，该名称包含rose绳子。

$ docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

格式化

格式化选项（--format）使用GO模板打印卷输出。

Go模板的有效占位符列在下面：

当使用--format选项，volume ls命令将按照模板声明的方式输出数据，或者在使用table指令，还包括列标题。

下面的示例使用没有标头的模板，并输出Name和Driver所有卷都用冒号分隔的条目：

$ docker volume ls --format "{{.Name}}: {{.Driver}}"vol1: local
vol2: local
vol3: local