标签操作

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

我的收藏

简介

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

设置标签

功能说明

为已存在的存储桶设置标签(PUT Bucket tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";

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

查询标签

功能说明

查询指定存储桶下已有的存储桶标签(GET Bucket tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";

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

删除标签

功能说明

删除指定存储桶下已有的存储桶标签(DELETE Bucket tagging)。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";

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