文档

mc tag list

语法

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

以下命令列出 myminio MinIO 部署中 mydata 存储桶的标签。

mc tag list myminio/mydata

该命令具有以下语法

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

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

  • 使用管道 | 运算符分隔的参数是相互排斥的。

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

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

参数

ALIAS
必需

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

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

RELEASE.2023-05-04T18-10-16Z 版本新增。

递归地列出指定给 ALIAS 的路径中所有对象的标签。

--rewind
可选

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

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

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

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

--versions
可选

指示 mc tag list 对存储桶中存在的全部对象版本进行操作。

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

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

--version-id, vid
可选

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

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

与以下参数互斥

全局标志

此命令支持任何 全局标志

示例

列出存储桶或对象的标签

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

mc tag list ALIAS/PATH
  • ALIAS 替换为 MinIO 部署的 别名

  • PATH 替换为 MinIO 部署上存储桶或对象的路径。

行为

S3 兼容性

命令行工具 mc 旨在与 AWS S3 API 兼容,并已通过 MinIO 和 AWS S3 测试,以确保其功能和行为符合预期。

对于其他 S3 兼容服务,MinIO 不提供任何保证,因为它们的 S3 API 实现未知且不受支持。虽然 mc 命令可能按文档工作,但任何此类使用均由您自行承担风险。