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

获取对象标签

功能介绍

获取对象标签。

接口约束

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

命令结构

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

运行示例

  • 以Windows操作系统为例,运行obsutil object-tagging obs://test-bucket/key -method=get,获取桶test-bucket中对象key标签配置信息。
    obsutil object-tagging obs://test-bucket/key -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 object [key] in the bucket [test-bucket] successfully, cost [2416] ms, request id [0000019AB625548A4015EF40BDBFDD61]

参数说明

参数

约束

描述

bucket

必选

桶名。

method

必选

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

config

附加参数,可选

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

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

相关链接

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

相关文档