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