# 获取对象标签
#### 功能介绍
获取对象标签。
#### 接口约束
您必须是对象拥有者或拥有获取对象标签的权限，才能获取对象标签。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:GetObjectTagging权限，如果使用桶策略则需授予GetObjectTagging权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。
#### 命令结构
- 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 | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 |
| e      | 附加参数，可选 | 指定终端节点。                                                                                           |
| i      | 附加参数，可选 | 指定用户的AK。                                                                                          |
| k      | 附加参数，可选 | 指定用户的SK。                                                                                          |
| t      | 附加参数，可选 | 指定用户的securitytoken。                                                                               |
   
#### 相关链接
- 关于获取对象标签的API说明，请参见[获取对象标签](https://support.huaweicloud.com/api-obs/obs_04_0164.html)。
- 获取对象标签过程中返回的错误码含义、问题原因及处理措施可参考[OBS错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#section1)。