文档

mc tag set

语法

mc tag set 命令将一个或多个标签设置为存储桶或对象。

MinIO 支持向对象添加最多 10 个自定义标签。

以下命令为 myminio MinIO 部署上的 mydata 存储桶设置标签

mc tag set myminio/mydata "tag1=value1&tag2=value2"

该命令具有以下语法

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

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

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

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

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

参数

ALIAS
必需

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

mc tag set myminio/mybucket/object.txt
TAGS
必需

一个用&号分隔的 (&) 键值对列表 (KEY=VALUE),其中每个对表示要分配给对象的标签。例如

mc tag set myminio/mybucket/object.txt "key1=value1&key2=value2"
--exclude-folders
可选

新增于 RELEASE.2024-01-11T05-49-32Z 版本。

当与--recursive一起使用时,会导致mc tag set **不**遍历子前缀。标签仅应用于指定路径上的对象。需要--recursive

以下示例将标签 destination=international 应用于 vacation-photos/cancun/ 中的对象,但不应用于 vacation-photos/cancun/ocean/ 或其他前缀。

例如,上述操作会将标签添加到 `vacation-photos/cancun/pretty-beach.jpg` 中的对象,但不会添加到 `vacation-photos/cancun/ocean/tropical-fish.jpg` 中的对象。

mc tag set myminio/vacation-photos/cancun "destination=international" --exclude-folders --recursive
--recursive, r
可选

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

递归地将标签应用于指定给 ALIAS 的路径上的所有对象。

--rewind
可选

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

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

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

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

--versions
可选

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

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

一起使用 --versions--rewind 可将标签应用于特定时间点存在的所有对象版本。

--version-id, --vid
可选

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

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

与以下参数互斥

全局标志

此命令支持任何全局标志

示例

将标签应用于存储桶或对象

使用 mc tag set 将标签应用于存储桶或对象

mc tag set ALIAS/PATH "TAGS"
  • ALIAS 替换为 MinIO 部署的别名

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

  • TAGS 替换为一个或多个用&号分隔的 (&) 键值对,每个键值对表示一个标签及其对应值。

行为

S3 兼容性

mc 命令行工具构建为与 AWS S3 API 兼容,并经过 MinIO 和 AWS S3 测试,以确保预期功能和行为。

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