标签管理

更新时间：2026-09-23

BOS 支持为 Object 绑定标签（Object Tagging），通过标签可对海量对象进行分类管理，并结合生命周期、权限策略等能力按标签维度进行操作。

运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name、object_key 替换为实际值。

设置对象标签

通过 put_object_tagging 方法，传入标签结构为 Object 设置标签：

                Python
                
            

                bucket_name = 'example-bucket-name'
object_key = 'example-object-key'

tag_conf = {
    "tagSet": [{
        "tagInfo": [
            {"key": "key1", "value": "value1"},
            {"key": "key2", "value": "value2"},
            {"key": "key3", "value": "value3"}
        ]
    }]
}

bos_client.put_object_tagging(bucket_name=bucket_name, key=object_key, obj_tag_args=tag_conf)
            

参数说明

参数	必填	说明
`bucket_name`	是	Bucket 名称。
`key`	是	Object 名称（Key）。
`obj_tag_args`	是	标签结构，形如 `{"tagSet": [{"tagInfo": [{"key": ..., "value": ...}]}]}`。

获取对象标签

                Python
                
                response = bos_client.get_object_tagging(bucket_name=bucket_name, key=object_key)
print(response)

删除对象标签

                Python
                
                response = bos_client.delete_object_tagging(bucket_name=bucket_name, key=object_key)
print(response)

方法说明

方法	返回值	说明
`bos_client.put_object_tagging(bucket_name, key, obj_tag_args)`	`BceResponse`	为 Object 设置标签。
`bos_client.get_object_tagging(bucket_name, key)`	`BceResponse`	获取 Object 的标签。
`bos_client.delete_object_tagging(bucket_name, key)`	`BceResponse`	删除 Object 的全部标签。

评价此篇文章

有帮助没帮助

软链接

日志控制

百度智能云

BOS 对象存储

BOS 对象存储

标签管理

设置对象标签

获取对象标签

删除对象标签