mc tag set
语法
Themc tag set命令集将一个或多个标签设置到存储桶或对象。
MinIO 支持为对象添加最多 10 个自定义标签。
以下命令用于设置标签：mydata桶上的myminioMinIO 部署：
mc tag set myminio/mydata "tag1=value1&tag2=value2"
该命令具有以下语法：
mc [GLOBALFLAGS] tag set \
[--rewind "string"] \
[--versions] \
[--version-id "string"]* \
ALIAS \
"TAGS"
Brackets
[]表示可选参数。共享同一行的参数是相互依赖的。
使用竖线分隔的参数
|操作符是互斥的。
将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。
mc tag set --version-id与多个参数互斥。有关更多信息，请参阅参考文档。
参数
- ALIAS
- 必需
The别名对于 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 setto 不遍历子前缀。 标签仅应用于指定路径上的对象。 需要--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
- 可选
Directs
mc tag set仅对指定时间点存在的对象版本进行操作。要回滚到过去的特定日期，请将日期指定为 ISO8601格式的时间戳。例如：
--rewind "2020.03.24T10:00".要倒回一段时间，请将持续时间指定为字符串，格式为
#d#hh#mm#ss格式。例如：--rewind "1d2hh3mm4ss".
--rewind要求指定的ALIAS成为兼容 S3 的服务 并支持Bucket Versioning对于 MinIO 部署，请使用mc version启用或禁用存储桶版本控制。
- --versions
- 可选
Directs
mc tag set对存储桶中存在的所有对象版本执行操作。--versions要求指定的ALIAS成为兼容 S3 的服务 并支持Bucket Versioning对于 MinIO 部署，请使用mc version启用或禁用存储桶版本控制。使用
--versions和--rewind共同应用标签到在特定时间点存在的所有对象版本。
- --version-id, --vid
- 可选
Directs
mc tag set仅对指定的对象版本进行操作。--version-id要求指定的ALIAS成为兼容 S3 的服务 并支持Bucket Versioning对于 MinIO 部署，请使用mc version启用或禁用存储桶版本控制。与以下参数互斥：
全局标志
此命令支持任何全局标志.
示例
行为
S3 Compatibility
Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。
MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。
