标签操作

最近更新时间:2024-12-30 10:52:22

我的收藏

简介

本文档提供关于对象的标签操作相关的 API 概览以及 SDK 示例代码。
API
操作名
操作描述
设置标签
为已存在的对象设置标签
查询标签
查询指定对象下已有的对象标签
删除标签
删除指定对象下已有的对象标签

设置标签

功能说明

为已存在的对象设置标签(PUT Object tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";
//对象在存储桶中的位置标识符,即称对象键
let cosPath = "exampleobject.txt";

let tagSet = new List<TagObject>();
tagSet.add(new TagObject("tag1", "value1"))
tagSet.add(new TagObject("tag2", "value2"))
let request = new PutObjectTagRequest(bucket,cosPath,tagSet);
try {
let result = await CosXmlBaseService.default().putObjectTag(request)
// result中包括http headers等
} catch (e) {
// 异常处理
}

查询标签

功能说明

查询指定对象下已有的对象标签(GET Object tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";
//对象在存储桶中的位置标识符,即称对象键
let cosPath = "exampleobject.txt";

let request = new GetObjectTagRequest(bucket, cosPath);
try {
let result = await CosXmlBaseService.default().getObjectTag(request)
// result中包括http headers等
} catch (e) {
// 异常处理
}

删除标签

功能说明

删除指定对象下已有的对象标签(DELETE Object tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";
//对象在存储桶中的位置标识符,即称对象键
let cosPath = "exampleobject.txt";

let request = new DeleteObjectTagRequest(bucket, cosPath);
try {
let result = await CosXmlBaseService.default().deleteObjectTag(request)
// result中包括http headers等
} catch (e) {
// 异常处理
}