切换语言

docker volume ls

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

描述

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

选项

选项默认描述
--clusterAPI 1.42+ Swarm仅显示集群卷，并使用集群卷列表格式
-f, --filter提供筛选值（例如 dangling=true）
--format使用自定义模板格式化输出：
'table': 以表格格式打印输出，带有列标题（默认）
'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出
'json': 以 JSON 格式打印
'TEMPLATE': 使用给定的 Go 模板打印输出。
参考https://docs.docker.com/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)
  • 驱动（卷驱动程序的名称）
  • 标签 (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)

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