`mc ls`

语法

该 mc ls 命令列出 MinIO 或其他与 S3 兼容的服务上的存储桶和对象。

您还可以对本地文件系统使用 mc ls 以产生与 ls 命令类似的结果。

示例

以下命令列出 myminio MinIO 部署上的 mydata 存储桶中的所有对象 *和* 对象版本

mc ls --recursive --versions myminio/mydata

输出类似于以下内容

[2022-11-08 11:30:24 PST]    52MB  STANDARD log-data.csv
[2022-11-09 12:20:18 PST]    120MB WARM videos/event-2022-11-09.mp4

STANDARD 标记存储在 MinIO 部署上的对象
WARM 标记存储在远程层上且名称匹配的对象
videos/ 指示对象的前缀

语法

该命令具有以下语法

mc [GLOBALFLAGS] ls              \
                 [--incomplete]  \
                 [--recursive]   \
                 [--rewind]      \
                 [--versions]    \
                 [--summarize]   \
                 ALIAS [ALIAS ...]

方括号 [] 表示可选参数。
共享同一行的参数是相互依赖的。
使用管道 | 运算符分隔的参数是互斥的。

将示例复制到文本编辑器中，并在终端/shell 中运行命令之前根据需要进行修改。

参数

ALIAS

必填要复制的对象或对象。

要列出 MinIO 上的对象，请指定别名和该对象的完整路径（例如，存储桶和对象路径）。例如

mc ls play/mybucket/object.txt

要列出本地文件系统上的对象，请指定该对象的完整路径。例如

mc ls ~/mydata/object.txt

如果将目录或存储桶指定给ALIAS，则还必须指定--recursive 以递归列出该目录或存储桶的内容。如果省略--recursive 参数，则ls 仅列出指定目录或存储桶顶层中的对象。

incomplete, -I: 可选返回指定ALIAS 存储桶上的任何不完整的上传。

--recursive, r: 可选递归列出ALIAS 中每个存储桶或目录的内容。

--rewind

可选

指示mc ls 仅对指定时间点存在的对象版本进行操作。

要回溯到过去的特定日期，请将日期指定为 ISO8601 格式的时间戳。例如：--rewind "2020.03.24T10:00"。
要回溯一段时间，请将持续时间指定为#d#hh#mm#ss 格式的字符串。例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的ALIAS 为支持存储桶版本控制的 S3 兼容服务。对于 MinIO 部署，请使用mc version 来启用或禁用存储桶版本控制。

将--rewind 和--versions 结合使用，以显示在特定时间点存在的那些对象版本。

--versions

可选

指示mc ls 对存储桶中存在的所有对象版本进行操作。

--versions 要求指定的ALIAS 为支持存储桶版本控制的 S3 兼容服务。对于 MinIO 部署，请使用mc version 来启用或禁用存储桶版本控制。

将--versions 和--rewind 结合使用，以显示在特定时间点存在的那些对象版本。

--summarize: 可选显示指定ALIAS 路径的摘要信息。

全局标志

此命令支持任何全局标志。

示例

列出存储桶内容

使用mc ls 列出存储桶的内容

mc ls [--recursive] ALIAS/PATH

将ALIAS 替换为 S3 兼容主机的别名。
将PATH 替换为 S3 兼容主机上存储桶的路径。

如果指定 S3 根目录的路径（仅ALIAS），请包含--recursive 选项。

列出对象版本

使用mc ls --versions 列出对象的全部版本

mc ls --versions ALIAS/PATH

将ALIAS 替换为 S3 兼容主机的别名。
将PATH 替换为 S3 兼容主机上存储桶或对象的路径。

需要版本控制

mc ls 需要存储桶版本控制才能使用此功能。使用mc version 启用存储桶的版本控制。

在时间点列出存储桶内容

使用mc ls --versions 列出对象的全部版本

mc ls --rewind DURATION ALIAS/PATH

将ALIAS 替换为 S3 兼容主机的别名。
将PATH 替换为 S3 兼容主机上存储桶或对象的路径。
将DURATION 替换为过去命令返回对象的时点。例如，指定30d 以返回当前日期前 30 天的对象版本。

需要版本控制

mc ls 需要存储桶版本控制才能使用此功能。使用mc version 启用存储桶的版本控制。

行为

S3 兼容性

mc 命令行工具构建为与 AWS S3 API 兼容，并已在 MinIO 和 AWS S3 上进行了测试，以确保预期功能和行为。

MinIO 不保证其他 S3 兼容服务，因为它们的 S3 API 实现未知，因此不受支持。虽然mc 命令可能按文档记录的方式工作，但任何此类用法均须自行承担风险。