名称

podman-volume-ls - 列出所有可用卷

简介

podman volume ls [选项]

描述

列出所有存在的卷。可以使用 --filter 标志进行过滤，并可以使用 --format 标志格式化为 JSON 或 Go 模板。使用 --quiet 标志仅打印卷名称。

选项

--filter, -f=过滤器

过滤输出中显示的卷。可以使用多个 --filter 标志来给出多个过滤器。具有相同键的过滤器是包含关系，唯一的例外是 label，它是排他关系。具有不同键的过滤器始终是排他关系。

卷可以通过以下属性进行过滤

过滤器	描述
悬空	[Dangling] 匹配所有未被任何容器引用的卷
驱动程序	[Driver] 根据其驱动程序匹配卷
label	[Key] 或 [Key=Value] 分配给卷的标签
name	[Name] 卷名称（接受正则表达式）
选项	匹配存储驱动程序选项
范围	按范围过滤卷
之后/以来	按给定 VOLUME（名称或标签）之后创建的卷进行过滤
until	仅删除在给定时间戳之前创建的卷

--format=格式

使用 Go 模板格式化卷输出。

Go 模板的有效占位符如下所列

占位符	描述
.匿名	指示卷是否是匿名的
.CreatedAt …	卷创建时间
.Driver	卷驱动程序
.GID	卷的 GID
.InspectVolumeData …	请勿使用
.Labels …	与卷关联的标签信息
.LockNumber	卷的 Libpod 锁的数量
.MountCount	卷被挂载的次数
.Mountpoint	卷挂载点的源
.Name	卷名称
.NeedsChown	指示卷是否需要更改所有者
.NeedsCopyUp	指示卷是否需要向上复制
.Options …	卷选项
.Scope	卷范围
.Status …	卷的状态
.StorageID	卷的 StorageID
.Timeout	卷的超时
.UID	卷的 UID
.VolumeConfigResponse …	请勿使用

--help

打印使用说明。

--noheading, -n

从列表中省略表格标题。

--quiet, -q

以静默模式打印卷输出。仅打印卷名称。

示例

列出所有卷。

$ podman volume ls

列出所有卷并以 JSON 格式显示内容。

$ podman volume ls --format json

列出所有卷并显示其 Driver 和 Scope 字段

$ podman volume ls --format "{{.Driver}} {{.Scope}}"

列出名称为 foo 且标签为 blue 的卷。

$ podman volume ls --filter name=foo,label=blue

列出标签为 key=value 的卷。

$ podman volume ls --filter label=key=value

另请参阅

podman(1), podman-volume(1)

历史

2018 年 11 月，由 Urvashi Mohnani umohnani@redhat.com 最初编译