腾讯云对象存储对象标签

简介

本文档提供关于对象标签的 API 概览以及 SDK 示例代码。

设置对象标签

功能说明

用于为对象设置标签。

方法原型

public SetObjectTaggingResult setObjectTagging(SetObjectTaggingRequest setObjectTaggingRequest);

请求示例1：对已上传的对象设置标签

String bucketName = "examplebucket-1250000000";String key = "exampletkey";List tags = new LinkedList();tags.add(new Tag("tag1", "value1"));tags.add(new Tag("tag2", "value2"));ObjectTagging objectTagging = new ObjectTagging(tags);SetObjectTaggingRequest setObjectTaggingRequest = new SetObjectTaggingRequest(bucketName, key, objectTagging);cosclient.setObjectTagging(setObjectTaggingRequest);

请求示例2：上传对象时设置标签

String bucketName = "examplebucket-1250000000";String key = "testfiles/testTagging.txt";InputStream is = new ByteArrayInputStream(new byte[]{'d', 'a', 't', 'a'});ObjectMetadata objectMetadata = new ObjectMetadata();objectMetadata.setHeader("x-cos-tagging", "tag1=value1&tag2=value2");cosclient.putObject(bucketName, key, is, objectMetadata);

参数说明

Request 成员说明：

ObjectTagging 成员说明：

Tag 成员说明：

返回结果说明

成功：无返回值。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。

查询对象标签

功能说明

查询指定对象下已有的对象标签。

方法原型

public GetObjectTaggingResult getObjectTagging(GetObjectTaggingRequest getObjectTaggingRequest);

请求示例

String bucketName = "exampletbucket-1250000000";String key = "exampletkey";GetObjectTaggingRequest getObjectTaggingRequest = new GetObjectTaggingRequest(bucketName, key);GetObjectTaggingResult getObjectTaggingResult = cosclient.getObjectTagging(getObjectTaggingRequest);List resultTagSet = getObjectTaggingResult.getTagSet();System.out.println(resultTagSet.toString());

参数说明

Request 成员说明：

返回结果说明

成功：返回 GetObjectTaggingResult，包含对象的标签信息。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。

删除对象标签

功能说明

用于删除指定对象的已有标签。

方法原型

public DeleteObjectTaggingResult deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest);

请求示例

String bucketName = "examplebucket-1250000000";String key = "exampleobject";DeleteObjectTaggingRequest deleteObjectTaggingRequest = new DeleteObjectTaggingRequest(bucketName, key);cosclient.deleteObjectTagging(deleteObjectTaggingRequest);

参数说明

Request 成员说明：

返回结果说明

成功：无返回值。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠