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
来启用或禁用存储桶版本控制。与以下参数互斥
全局标志
此命令支持任何全局标志。
示例
行为
S3 兼容性
mc 命令行工具构建为与 AWS S3 API 兼容,并经过 MinIO 和 AWS S3 测试,以确保预期功能和行为。
MinIO 对其他与 S3 兼容的服务不提供任何保证,因为它们的 S3 API 实现未知,因此不受支持。虽然 mc 命令 *可能* 按文档记录的方式工作,但任何此类使用均需自行承担风险。