名称

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

概要

podman volume ls [选项]

描述

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

选项

--filter, -f=filter

过滤输出中显示的卷。可以使用多个 --filter 标志提供多个过滤器。具有相同键的过滤器包含性地工作，唯一的例外是 label，它是排他性的。具有不同键的过滤器总是排他性地工作。

可以通过以下属性过滤卷

过滤器	描述
dangling	[悬挂] 匹配所有未被任何容器引用的卷
driver	[驱动程序] 根据驱动程序匹配卷
label	[键] 或 [键=值] 分配给卷的标签
name	[名称] 卷名称（接受正则表达式）
opt	匹配存储驱动程序选项
scope	按范围过滤卷
after/since	按在给定卷（名称或标签）之后创建的卷进行过滤
until	仅删除在给定时间戳之前创建的卷

--format=format

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

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

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

--help

打印使用说明。

--noheading, -n

从列表中省略表格标题。

--quiet, -q

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

示例

列出所有卷。

$ podman volume ls

列出所有卷并将内容显示为 json 格式。

$ podman volume ls --format json

列出所有卷并显示其驱动程序和范围字段

$ 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 编译