获取对象标签

功能介绍

可通过本接口获取对象的标签信息。了解更多对象标签相关信息，请参考对象标签。

如果请求中不携带版本号（versionId），需要确保执行者有GetObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。

默认获取Object当前版本的标签信息。可以通过指定versionId参数来获取指定Object版本的标签信息。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。

接口约束

• 对象标签功能目前在公测阶段，免费使用；公测结束后，将收取费用。
• 用户读写对象标签必须拥有对应标签操作权限，当前可通过设置桶策略授权给其他用户。默认情况下只有对象的所有者可以执行此操作。
• 暂不支持CRR，即跨区域复制时，源对象标签不会被复制到目标桶。
• 并行文件系统不支持给文件添加标签。

• 每个对象最多能设置10个标签。
• 标签的键值约束：

  键名（Key）区分大小写且必须唯一，不能为空且不能超过128个字符，不允许使用,/|<>=*\字符。

  键值（Value）区分大小写且可以为空，不能超过255个字符，不允许使用,/|<>=*\字符。

方法定义

obsClient.getObjectTagging(ObjectTaggingRequest request)

请求参数说明

返回结果说明

代码示例

本示例用于获取examplebucket桶中objectname对象的对象标签。

import android.util.Log;

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 GetObjectTaggingDemo {
    private static final String TAG = "GetObjectTaggingDemo";

    public void getObjectTagging() {
        // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY_ID。
        // 您可以登录访问管理控制台获取访问密钥AK/SK
        String ak = System.getenv("ACCESS_KEY_ID");
        String sk = System.getenv("SECRET_ACCESS_KEY_ID");
        // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。
        // String securityToken = System.getenv("SECURITY_TOKEN");
        // endpoint填写桶所在的endpoint, 此处以华北-北京四为例，其他地区请按实际情况填写。
        String endPoint = "https://your-endpoint";

        // 创建ObsClient实例
        ObsClient obsClient = new ObsClient(ak, sk, endPoint);

        try {
            // 获取对象标签
            String bucketName = "examplebucket";
            String objectKey = "objectname";
            String objectVersionId = "";
            ObjectTaggingRequest objectTaggingRequest =
                    new ObjectTaggingRequest(bucketName, objectKey, objectVersionId, null);
            ObjectTagResult objectTagResult = obsClient.getObjectTagging(objectTaggingRequest);
            Log.i(TAG, "tags of " + objectKey + ":");
            List<TagSet.Tag> tags = objectTagResult.getTagSet().getTags();
            for (TagSet.Tag tag : tags) {
                Log.i(TAG, "tag key:" + tag.getKey() + ", tag value:" + tag.getValue());
            }
            Log.i(TAG, "GetObjectTagging successfully");
        } catch (ObsException e) {
            Log.e(TAG, "GetObjectTagging failed");
            // 请求失败,打印http状态码
            Log.e(TAG, "HTTP Code:" + e.getResponseCode());
            // 请求失败,打印服务端错误码
            Log.e(TAG, "Error Code:" + e.getErrorCode());
            // 请求失败,打印详细错误信息
            Log.e(TAG, "Error Message:" + e.getErrorMessage());
            // 请求失败,打印请求id
            Log.e(TAG, "Request ID:" + e.getErrorRequestId());
            Log.e(TAG, "Host ID:" + e.getErrorHostId());
        } catch (Exception e) {
            Log.e(TAG, "GetObjectTagging failed");
            // 其他异常信息打印
            Log.e(TAG, e.getMessage());
        }
    }
}