NAME¶ 名称

podman-volume-ls - List all the available volumes
podman-volume-ls - 列出所有可用的卷

SYNOPSIS¶ 概要

podman volume ls [options]
podman volume ls [选项]

DESCRIPTION¶ 描述

Lists all the volumes that exist. The output can be filtered using the --filter flag and can be formatted to either JSON or a Go template using the --format flag. Use the --quiet flag to print only the volume names.
列出所有存在的卷。可以使用 --filter 标志对输出进行过滤，并可以使用 --format 标志将其格式化为 JSON 或 Go 模板。使用 --quiet 标志仅打印卷名称。

OPTIONS¶ 选项

--filter, -f=filter¶ --filter, -f=过滤器 ¶

Filter what volumes are shown in the output. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive, with the only exception being label which is exclusive. Filters with different keys always work exclusive.
过滤输出中显示的卷。可以使用多个 --filter 标志多次给出多个过滤器。具有相同键的过滤器是包容的，唯一的例外是 label 是排他的。具有不同键的过滤器始终是排他的。

Volumes can be filtered by the following attributes:
可以按以下属性过滤卷：

Filter	Description
dangling	[Dangling] Matches all volumes not referenced by any containers [悬空] 匹配所有未被任何容器引用的卷
driver	[Driver] Matches volumes based on their driver [驱动程序] 根据其驱动程序匹配卷
label	[Key] or [Key=Value] Label assigned to a volume [键] 或 [键=值] 分配给卷的标签
name	[Name] Volume name (accepts regex) [名称] 卷名称（接受正则表达式）
opt	Matches a storage driver options 匹配存储驱动器选项
scope	Filters volume by scope 按范围过滤卷
after/since 之后/自从	Filter by volumes created after the given VOLUME (name or tag) 按照给定的卷（名称或标签）创建的卷进行过滤
until	Only remove volumes created before given timestamp 仅删除在给定时间戳之前创建的卷

--format=format¶

Format volume output using Go template.
使用 Go 模板格式化卷输出。

Valid placeholders for the Go template are listed below:
Go 模板的有效占位符如下所示：

Placeholder	Description
.Anonymous	Indicates whether volume is anonymous 指示卷是否匿名
.CreatedAt … 创建时间 …	Volume creation time 卷创建时间
.Driver	Volume driver 卷驱动程序
.GID	GID of volume 卷的 GID
.InspectVolumeData … .检查卷数据…	Don’t use 不要使用
.Labels … .标签 …	Label information associated with the volume 与卷相关的标签信息
.LockNumber	Number of the volume’s Libpod lock 卷的 Libpod 锁的编号
.MountCount	Number of times the volume is mounted 挂载卷的次数
.Mountpoint	Source of volume mount point 卷挂载点的来源
.Name	Volume name 卷名称
.NeedsChown	Indicates whether volume needs to be chowned 指示卷是否需要更改所有者
.NeedsCopyUp	Indicates if volume needs to be copied up to 指示是否需要将卷复制到
.Options … .选项...	Volume options 卷选项
.Scope	Volume scope 卷范围
.Status … .状态 …	Status of the volume 卷的状态
.StorageID	StorageID of the volume 卷的存储 ID
.Timeout	Timeout of the volume 卷的超时时间
.UID	UID of volume 卷的 UID
.VolumeConfigResponse …	Don’t use 不要使用

--help¶ --帮助 ¶

Print usage statement. 打印使用说明。

--noheading, -n¶ --noheading，-n ¶

Omit the table headings from the listing.
从列表中省略表头。

--quiet, -q¶

Print volume output in quiet mode. Only print the volume names.
在安静模式下打印卷输出。只打印卷名称。

EXAMPLES¶ 示例

List all volumes. 列出所有卷。

$ podman volume ls

List all volumes and display content as json format.
列出所有卷并以 JSON 格式显示内容。

$ podman volume ls --format json

List all volumes and display their Driver and Scope fields
列出所有卷并显示它们的 Driver 和 Scope 字段。

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

List volumes with the name foo and label blue.
列出名称为 foo 且标签为 blue 的卷。

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

List volumes with the label key=value.
列出带有标签键值对的卷。

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

HISTORY¶ 历史 ¶

November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com
2018 年 11 月，最初由 Urvashi Mohnani umohnani@redhat.com 编译