# 获取对象标签(Java SDK)
#### 功能介绍
可通过本接口获取对象的标签信息。了解更多对象标签相关信息，请参考[对象标签](https://support.huaweicloud.com/usermanual-obs/obs_41_0054.html)。
如果请求中不携带版本号（versionId），需要确保执行者有GetObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。
默认获取Object当前版本的标签信息。可以通过指定versionId参数来获取指定Object版本的标签信息。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。
#### 接口约束
- 对象标签功能目前在公测阶段，免费使用；公测结束后，将收取费用。
- 用户读写对象标签必须拥有对应标签操作权限，当前可通过设置桶策略授权给其他用户。默认情况下只有对象的所有者可以执行此操作。
- 用户可在PUT上传、分段上传、上传、复制对象过程中设置标签，也可以对已上传的对象设置标签。
- 设置或更改对象标签不会改变对象的Lastmodified时间。
- 暂不支持CRR，即跨区域复制时，源对象标签不会被复制到目标桶。
- 并行文件系统不支持给文件添加标签。

- 每个对象最多能设置10个标签。
- 标签的键值约束： 键名（Key）区分大小写且必须唯一，不能为空且不能超过128个字符，不允许使用,/\|\<\>=\*\\字符。
  键值（Value）区分大小写且可以为空，不能超过255个字符，不允许使用,/\|\<\>=\*\\字符。
  
 
#### 方法定义
obsClient.getObjectTagging(ObjectTaggingRequest request)
#### 请求参数说明
表1请求参数列表 
| **参数名称** | **参数类型**                                                                                                                                                 | **是否必选** | **描述**                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| request      | [ObjectTaggingRequest](https://support.huaweicloud.com/sdk-java-devg-obs/zh-cn_topic_0000001895350256.html#zh-cn_topic_0000001895350256__table20134162415330) | 必选             | **参数解释** **：** 获取对象标签请求参数，详见[ObjectTaggingRequest](https://support.huaweicloud.com/sdk-java-devg-obs/zh-cn_topic_0000001895350256.html#zh-cn_topic_0000001895350256__table20134162415330)。 |
   
#### 返回结果说明
表2返回结果如下 
| **方法名称**             | **返回值类型**             | **说明** |
|:---|:---|:---|
| getObjectTagging(ObjectTaggingRequest request) | [ObjectTagResult] | 用于获取对象标签。                         |
   
 表3ObjectTagResult 
| **参数名称**                                  | **参数类型**                                               | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| tagSet                                  | [TagSet]               | **参数解释：** 对象标签，用于标识对象。详见[TagSet]。 **默认取值：** 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| statusCode | int                         | **参数解释：** HTTP状态码。 **取值范围：** 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。 完整的状态码列表请参见[状态码](https://support.huaweicloud.com/api-obs/obs_04_0114.html)。 **默认取值：** 无 |
| responseHeaders              | Map\<String, Object\> | **参数解释：** HTTP响应消息头列表，由多个元组构成。元组中String代表响应消息头的名称，Object代表响应消息头的值。 **默认取值：** 无                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表4TagSet 
| **参数名称** | **参数类型**                                      | **描述**                                                                                            |
|:---|:---|:---|
| tags     | List\<[Tag]\> | **参数解释：** 对象标签列表，详见[Tag]。 |
   
 表5Tag 
| **参数名称** | **参数类型** | **描述**                                                                                                                                                                                                         |
|:---|:---|:---|
| key        | String | **参数解释：** 标签的名字。 **默认取值：** 无 |
| value      | String  | **参数解释：** 标签的值。 **默认取值：** 无       |
   
#### 示例代码
本示例用于获取examplebucketname桶中exampleObjectKey对象的对象标签。
```
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.BucketTagInfo.TagSet;
import com.obs.services.model.ObjectTagResult;
import com.obs.services.model.ObjectTaggingRequest;
import java.util.List;
public class GetObjectTagging001 {
    public static void main(String[] args) {
        // 您可以通过环境变量获取访问密钥AK/SK，也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
        // 您可以登录访问管理控制台获取访问密钥AK/SK
        String ak = System.getenv("ACCESS_KEY_ID");
        String sk = System.getenv("SECRET_ACCESS_KEY_ID");
        // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。
        // 您可以通过环境变量获取访问密钥AK/SK/SecurityToken，也可以使用其他外部引入方式传入。
        String securityToken = System.getenv("SECURITY_TOKEN");
        // endpoint填写桶所在的endpoint, 此处以华北-北京四为例，其他地区请按实际情况填写。
        String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
        // 您可以通过环境变量获取endPoint，也可以使用其他外部引入方式传入。
        //String endPoint = System.getenv("ENDPOINT")
        // 创建ObsClient实例
        try (ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint)) {
            // 获取对象标签
            String bucketName = "examplebucketname";
            String objectKey = "exampleObjectKey";
            String objectVersionId = "";
            ObjectTaggingRequest objectTaggingRequest =
                    new ObjectTaggingRequest(bucketName, objectKey, objectVersionId, null);
            ObjectTagResult objectTagResult = obsClient.getObjectTagging(objectTaggingRequest);
            System.out.println("tags of " + objectKey + ":");
            List<TagSet.Tag> tags = objectTagResult.getTagSet().getTags();
            for (TagSet.Tag tag : tags) {
                System.out.println("tag key:" + tag.getKey() + ", tag value:" + tag.getValue());
            }
            System.out.println("GetObjectTagging successfully");
        } catch (ObsException e) {
            System.out.println("GetObjectTagging failed");
            // 请求失败,打印http状态码
            System.out.println("HTTP Code:" + e.getResponseCode());
            // 请求失败,打印服务端错误码
            System.out.println("Error Code:" + e.getErrorCode());
            // 请求失败,打印详细错误信息
            System.out.println("Error Message:" + e.getErrorMessage());
            // 请求失败,打印请求id
            System.out.println("Request ID:" + e.getErrorRequestId());
            System.out.println("Host ID:" + e.getErrorHostId());
            e.printStackTrace();
        } catch (Exception e) {
            System.out.println("GetObjectTagging failed");
            // 其他异常信息打印
            e.printStackTrace();
        }
    }
}
```