更新时间:2026-04-28 GMT+08:00
分享

设置桶标签

功能介绍

设置桶标签。

接口约束

  • 您必须是桶拥有者或拥有设置桶标签的权限,才能设置桶标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketTagging权限,如果使用桶策略则需授予PutBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略自定义创建桶策略

命令结构

  • Windows操作系统
    obsutil bucket-tagging obs://bucket -method=put -tag1 key1=value1 [-tagN keyN=valueN] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    ./obsutil bucket-tagging obs://bucket -method=put -tag1 key1=value1 [-tagN keyN=valueN] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例,运行obsutil bucket-tagging obs://test-bucket -method=put -tag key1=value1 -tag key2=value2,指定给桶test-bucket设置桶标签,分别是key1 value1和 key2 value2。
    obsutil bucket-tagging obs://test-bucket -method=put -tag key1=value1 -tag key2=value2 
    
    Start at 2024-09-30 07:59:28.8675681 +0000 UTC
    
    Put tagging succeed for bucket [test-bucket], requestId is [00000199765243C44018D688E9F5CFF5]

参数说明

参数

约束

描述

bucket

必选

桶名。

method

必选

指定方法,设置桶标签时该值为put。

tag

必选

指定桶的标签键值对,格式为key=value

config

附加参数,可选

运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

相关链接

  • 关于设置桶标签的API说明,请参见设置桶标签
  • 设置桶标签过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码

相关文档