mc ls

参数

ALIAS

必需 要复制的一个或多个对象。

对于在 MinIO 上列出对象，请指定 alias （别名） 以及到该对象的全路径 （例如，存储桶和对象路径）。 例如：

mc ls play/mybucket/object.txt

对于在本地文件系统上列出对象，请指定到该 对象的全路径。 例如：

mc ls ~/mydata/object.txt

如果您向 ALIAS 命令中指定了目录或存储桶， 为了递归地列出该目录或存储桶的内容， 您也必须指定 --recursive 参数。 如果您省略了 --recursive 参数，ls 命令 只会列出指定目录或存储桶顶层的对象。

incomplete, -I

可选 返回在指定 ALIAS 存储桶上的任何未完成的上传。

--recursive, r

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

--rewind

Optional

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

• 要回退到过去的特定日期，请将日期指定 为 ISO8601 格式的时间戳。例如： --rewind 2020.03.24T10:00 。

• 要回退一段时间，请将持续时间指定为字符串格式， 例如 #d#hh#mm#ss 。例如： --rewind 1d2hh3mm4ss 。

--rewind 命令要求指定的 ALIAS 是一个支持 桶版本控制 的 S3 兼容服务。 对于 MinIO 部署，使用 mc version 命令来启用或禁用桶版本控制。

使用 --rewind 和 --versions 命令一起，可以显示在特定时间点存在的 那些对象版本。

--versions

Optional

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

--versions 命令要求指定的 ALIAS 是一个支持 桶版本控制 的 S3 兼容服务。 对于 MinIO 部署，使用 mc version 命令来启用或禁用桶版本控制。

使用 --versions 和 --rewind 命令一起，可以显示在特定时间点存在的 那些对象版本。

--summarize

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

全局标记

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

列出存储桶内容

使用 mc ls 命令来列出存储桶的内容：

mc ls [--recursive] ALIAS/PATH

• 将 ALIAS 替换为 S3 兼容 主机的 alias。

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

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

列出对象版本

使用 mc ls --versions 命令来列出一个对象的所有版本：

mc ls --versions ALIAS/PATH

• 将 ALIAS 替换为 S3 兼容 主机的 alias。

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

列出时间点的存储桶内容

使用 mc ls --versions 命令来列出某个对象的所有版本：

mc ls --rewind DURATION ALIAS/PATH

• 将 ALIAS 替换为 S3 兼容 主机的 alias。

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

• 将 DURATION 替换为过去的特定时间点， 该命令会返回在此时间点的对象版本。例如，指定 30d 以 返回当前日期前30天的对象版本。

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并且已经过测试， 以确保在与 MinIO 和 AWS S3 配合使用时，功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是 未知的，因此不受支持。尽管 mc 命令 可能 如文档中所 述工作，但任何此类使用都是您自己的风险。