控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

对象标签

最近更新时间:2021-07-27 10:56:23

简介

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

API 操作名 操作描述
PUT Object tagging 设置对象标签 为对象设置标签
GET Object tagging 查询对象标签 查询指定对象下已有的对象标签
DELETE Object tagging 删除对象标签 删除指定对象下已有的对象标签

设置对象标签

功能说明

用于为对象设置标签。

方法原型

public SetObjectTaggingResult setObjectTagging(SetObjectTaggingRequest setObjectTaggingRequest);

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

String bucketName = "examplebucket-1250000000";
String key = "exampletkey";
List<Tag> 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);

参数说明

参数名称 描述 类型
setObjectTaggingRequest 对象标签设置请求 SetObjectTaggingRequest

Request 成员说明:

Request 成员 设置方法 描述 类型
bucketName 构造函数或 set 方法 设置标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 String
key 构造函数或者 set 方法 设置标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 String
objectTagging 构造函数或 set 方法 对象的标签配置 ObjectTagging

ObjectTagging 成员说明:

参数名称 描述 类型
tagSet 对象的标签配置集合 List<Tag>

Tag 成员说明:

参数名称 描述 类型
key 标签的 key String
value 标签的 value String

返回结果说明

  • 成功:无返回值。
  • 失败:发生错误(如身份认证失败),抛出异常 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<Tag> resultTagSet = getObjectTaggingResult.getTagSet();
System.out.println(resultTagSet.toString());

参数说明

参数名称 描述 类型
getObjectTaggingRequest 对象标签查询请求 GetObjectTaggingRequest

Request 成员说明:

Request 成员 设置方法 描述 类型
bucketName 构造函数或 set 方法 设置标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 String
key 构造函数或者 set 方法 设置标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 String

返回结果说明

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

删除对象标签

功能说明

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

方法原型

public DeleteObjectTaggingResult deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest);

请求示例

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

参数说明

参数名称 描述 类型
deleteObjectTaggingRequest 对象标签删除请求 DeleteObjectTaggingRequest

Request 成员说明:

Request 成员 设置方法 描述 类型
bucketName 构造函数或 set 方法 设置标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 String
key 构造函数或者 set 方法 设置标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 String

返回结果说明

  • 成功:无返回值。
  • 失败:发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理
目录