docker volume ls

描述列出卷
用法docker volume ls [OPTIONS]
别名
docker volume list

描述

列出 Docker 已知的全部卷。可以使用-f 或 --filter 标记进行筛选。有关可用筛选选项的更多信息，请参阅筛选部分。

选项

选项默认值描述
--clusterAPI 1.42+ 集群 只显示集群卷，并使用集群卷列表格式
-f, --filter提供筛选值（例如：dangling=true）
--format使用自定义模板格式化输出
'table': 以表格格式打印输出，包含列标题（默认）
'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出
'json': 以 JSON 格式打印
'TEMPLATE': 使用给定的 Go 模板打印输出。
有关使用模板格式化输出的更多信息，请参阅https://docs.dockerd.com.cn/go/formatting/。
-q, --quiet仅显示卷名称

示例

创建卷

$ docker volume create rosemary

rosemary

$ docker volume create tyler

tyler

$ docker volume ls

DRIVER              VOLUME NAME
local               rosemary
local               tyler

筛选（--filter）

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

当前支持的筛选器为：

  • dangling（布尔值 - true 或 false，0 或 1）
  • driver（卷驱动程序的名称）
  • label（label=<key> 或 label=<key>=<value>）
  • name（卷的名称）

dangling

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

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

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

driver

driver 筛选器根据卷的驱动程序匹配卷。

以下示例匹配使用local驱动程序创建的卷。

$ docker volume ls -f driver=local

DRIVER              VOLUME NAME
local               rosemary
local               tyler

label

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

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

以下筛选器匹配名称包含rose 字符串的所有卷。

$ docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

格式化输出（--format）

格式化选项 (--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

要以 JSON 格式列出所有卷，请使用json 指令。

$ docker volume ls --format json
{"Driver":"local","Labels":"","Links":"N/A","Mountpoint":"/var/lib/docker/volumes/docker-cli-dev-cache/_data","Name":"docker-cli-dev-cache","Scope":"local","Size":"N/A"}