docker volume ls
docker volume ls
描述
列表卷
用法
docker volume ls [OPTIONS]
备选方案
| 名字，简写 | 默认 | 描述 |
|---|---|---|
| --filter, -f | | 提供过滤器值（例如'dangling = true'） |
| --format | | 使用Go模板的漂亮打印卷 |
| --quiet, -q | 假 | 只显示卷名称 |
父命令
| 命令 | 描述 |
|---|---|
| docker volume | 管理卷 |
相关命令
| 命令 | 描述 |
|---|---|
| docker volume create | 创建一个卷 |
| docker volume inspect | 显示一个或多个卷的详细信息 |
| docker volume ls | 列出卷 |
| docker volume prune | 删除所有未使用的卷 |
| docker volume rm | 删除一个或多个卷 |
扩展描述
列出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=true
DRIVER 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模板的有效占位符列在下面：
| 占位符 | 描述 |
|---|---|
| .Name | 卷名称 |
| .Driver | 卷驱动程序 |
| .Scope | 卷范围（本地，全局） |
| .Mountpoint | 主机上卷的安装点 |
| .Labels | 分配给该卷的所有标签 |
| .Label | 此卷的特定标签的值。例如{{.Label“project.version”}} |
当使用--format选项，volume ls命令将按照模板声明的方式输出数据，或者在使用table指令，还包括列标题。
下面的示例使用没有标头的模板，并输出Name和Driver所有卷都用冒号分隔的条目：
$ docker volume ls --format "{{.Name}}: {{.Driver}}"
vol1: local
vol2: local
vol3: local
