mc ls
语法
Themc ls命令列出 MinIO 或其他 S3 兼容服务上的存储桶和对象。
你也可以使用mc ls针对本地文件系统产生类似
结果ls命令。
以下命令列出所有对象和对象版本在mydata桶上的myminioMinIO 部署：
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 ...]
Brackets
[]表示可选参数。共享同一行的参数是相互依赖的。
使用竖线分隔的参数
|操作符是互斥的。
将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。
参数
- ALIAS
必需要复制的一个或多个对象。
对于在 MinIO 上列出对象， 请指定别名以及该对象的完整路径（例如存储桶和对象路径）。例如：
mc ls play/mybucket/object.txt
要在本地文件系统中列出对象，请指定该对象的完整路径。例如：
mc ls ~/mydata/object.txt
如果您指定一个目录或存储桶
ALIAS，您还必须指定--recursive递归列出 该目录或存储桶的内容。如果省略--recursive参数，ls仅列出指定目录或存储桶顶层中的对象。
- 不完整， -I
可选返回指定路径上的任何未完成上传
ALIASbucket.
- --recursive, r
可选递归列出每个存储桶或目录中的内容
ALIAS.
- --rewind
- 可选
Directs
mc ls仅对指定时间点存在的对象版本进行操作。要回滚到过去的特定日期，请将日期指定为 ISO8601格式的时间戳。例如：
--rewind "2020.03.24T10:00".要倒回一段时间，请将持续时间指定为字符串，格式为
#d#hh#mm#ss格式。例如：--rewind "1d2hh3mm4ss".
--rewind要求指定的ALIAS成为兼容 S3 的服务 并支持Bucket Versioning对于 MinIO 部署，请使用mc version启用或禁用存储桶版本控制。使用
--rewind和--versions一起显示在特定时间点存在的那些对象版本上。
- --versions
- 可选
Directs
mc ls对存储桶中存在的所有对象版本执行操作。--versions要求指定的ALIAS成为兼容 S3 的服务 并支持Bucket Versioning对于 MinIO 部署，请使用mc version启用或禁用存储桶版本控制。使用
--versions和--rewind一起显示在特定时间点存在的那些对象版本上。
全局标志
此命令支持任何全局标志.
示例
列出存储桶内容
使用mc ls要列出存储桶的内容：
mc ls [--recursive] ALIAS/PATH
替换
PATH使用指向 S3 兼容主机上存储桶的路径。如果指定到 S3 根目录的路径（
ALIAS仅), 包含--recursive选项。
列出对象版本
使用mc ls --versions要列出对象的所有版本：
mc ls --versions ALIAS/PATH
需要版本控制
mc ls需要bucket versioning要使用此功能。mc version对存储桶启用版本控制。
列出特定时间点的存储桶内容
使用mc ls --versions要列出对象的所有版本：
mc ls --rewind DURATION ALIAS/PATH
需要版本控制
mc ls需要bucket versioning要使用此功能。mc version对存储桶启用版本控制。
行为
S3 Compatibility
Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。
MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。
