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

获取桶标签

功能介绍

获取桶标签。

接口约束

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

命令结构

  • Windows操作系统
    obsutil bucket-tagging obs://bucket -method=get [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    ./obsutil bucket-tagging obs://bucket -method=get [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例,运行obsutil bucket-tagging obs://test-bucket -method=get,获取桶test-bucket的标签配置信息。
    obsutil bucket-tagging obs://test-bucket -method=get
    
    Start at 2024-09-30 07:59:28.8675681 +0000 UTC
    
    Index                    Tag Key             Tag Value
    0                        key1                value1
    
    1                        key2                value2
    
    Get tagging succeed for bucket [test-bucket], requestId is [0000019AB614A37A40193E25E4C543CA], count is [2]

参数说明

参数

约束

描述

bucket

必选

桶名。

method

必选

指定方法,获取桶标签时该值为get。

config

附加参数,可选

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

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

相关链接

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

相关文档