文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc tag list

语法

Themc tag list命令列出存储桶或对象中的所有标签。

以下命令列出标签mydata桶上的myminioMinIO 部署:

mc tag list myminio/mydata

该命令具有以下语法:

mc [GLOBALFLAGS] tag set                   \
                 [--rewind "string"]       \
                 [--versions]              \
                 [--version-id "string"]*  \
                 ALIAS
  • Brackets[]表示可选参数。

  • 共享同一行的参数是相互依赖的。

  • 使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中,根据需要修改,然后在终端/Shell中运行命令。

mc tag list --version-id与多个参数互斥。有关更多信息,请参阅参考文档。

参数

ALIAS
必需

The别名对于 MinIO 部署和 要列出所有标签的对象的完整路径(例如存储桶和对象路径)。 例如:

mc tag list myminio/mybucket/object.txt
--recursive, r
可选

版本 RELEASE.2023-05-04T18-10-16Z 中的新增内容。

递归列出指定路径下所有对象的标签ALIAS.

--rewind
可选

Directsmc tag list仅对指定时间点存在的对象版本进行操作。

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

  • 要倒回一段时间,请将持续时间指定为字符串,格式为#d#hh#mm#ss格式。例如:--rewind "1d2hh3mm4ss".

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

--versions
可选

Directsmc tag list对存储桶中存在的所有对象版本执行操作。

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

使用--versions--rewind共同列出在特定时间点存在的所有对象版本标签。

--version-id, vid
可选

Directsmc tag list仅对指定的对象版本进行操作。

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

与以下参数互斥:

全局标志

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

示例

列出存储桶或对象的标签

使用mc tag list要列出存储桶或对象的标签:

mc tag list ALIAS/PATH
  • 替换ALIAS随着别名MinIO 部署的。

  • 替换PATH使用指向 MinIO 部署中存储桶或对象的路径。

行为

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建,并已通过 MinIO 和 AWS S3 测试,确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证,因为它们的 S3 API 实现方式未知,因此不受支持。尽管mc命令可能按文档所述工作,任何此类使用风险自负。