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

SEE ALSO 参见 ¶

podman(1), podman-volume(1)
podman(1),podman-volume(1)

HISTORY 历史 ¶

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