腾讯云对象存储对象标签

简介

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

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

设置对象标签

功能说明

为已存在的对象设置标签。

请求示例

cos.putObjectTagging({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Key: '1.png', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */    Tags: [        {"Key": "k1", "Value": "v1"},        {"Key": "k2", "Value": "v2"}    ],    // VersionId: 'MTg0NDUwOTMyODM1MDg2MTA1xxx' /* 对象版本 ID，非必须 */}, function(err, data) {    console.log(err || data);});

参数说明

参数名	参数描述	类型	是否必填
Bucket	设置对象标签的存储桶，格式：BucketName-APPID	String	是
Region	存储桶所在地域，枚举值请参见地域和访问域名	String	是
Key	对象键（Object 的名称），对象在存储桶中的唯一标识，详情请参见对象概述	String	是
Tags	标签信息	ObjectArray	是
– Key	标签名	String	是
– Value	标签值	String	是
VersionId	当启用版本控制时，指定要操作的对象版本 ID，如不指定则将添加标签到最新版本的对象	String	否

回调函数说明

function(err, data) { ... }

参数名	参数描述	类型
err	请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，更多详情请参见错误码文档	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object
data	请求成功时返回的对象，如果请求发生错误，则为空	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object

查询对象标签

功能说明

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

请求示例

cos.getObjectTagging({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Key: '1.png', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */}, function(err, data) {    console.log(err || data);});

返回示例

{    "Tags": [        {"Key": "k1", "Value": "v1"},        {"Key": "k2", "Value": "v2"}    ],    "statusCode": 200,    "headers": {}}

参数说明

参数名	参数描述	类型	是否必填
Bucket	查询对象标签的存储桶，格式：BucketName-APPID	String	是
Region	存储桶所在地域，枚举值请参见地域和访问域名	String	是
Key	对象键（Object 的名称），对象在存储桶中的唯一标识，详情请参见对象概述	String	是

回调函数说明

function(err, data) { ... }

参数名	参数描述	类型
err	请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，更多详情请参见错误码文档	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object
data	请求成功时返回的对象，如果请求发生错误，则为空	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object
– Tags	标签信息	ObjectArray
– – Key	标签名	String
– – Value	标签值	String

删除对象标签

功能说明

删除指定的对象标签。

请求示例

cos.deleteObjectTagging({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Key: '1.png', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */}, function(err, data) {    console.log(err || data);});

参数说明

参数名	描述	类型	是否必填
Bucket	删除对象标签的存储桶，格式：BucketName-APPID	String	是
Region	存储桶所在地域，枚举值请参见地域和访问域名	String	是
Key	对象键（Object 的名称），对象在存储桶中的唯一标识，详情请参见对象概述	String	是

回调函数说明

function(err, data) { ... }

参数名	参数描述	类型
err	请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，更多详情请参见错误码文档	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object
data	请求成功时返回的对象，如果请求发生错误，则为空	Object
– statusCode	请求返回的 HTTP 状态码，例如200、403、404等	Number
– headers	请求返回的头部信息	Object

对象存储官网1折活动，限时活动，即将结束，速速收藏
 同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

转转请注明出处：https://www.yunxiaoer.com/146117.html

腾讯云对象存储对象标签

简介

设置对象标签

功能说明

请求示例

参数说明

回调函数说明

查询对象标签

功能说明

请求示例

返回示例

参数说明

回调函数说明

删除对象标签

功能说明

请求示例

参数说明

回调函数说明

联系我们

400-800-8888

腾讯云对象存储对象标签

简介

设置对象标签

功能说明

请求示例

参数说明

回调函数说明

查询对象标签

功能说明

请求示例

返回示例

参数说明

回调函数说明

删除对象标签

功能说明

请求示例

参数说明

回调函数说明

相关推荐

腾讯云云函数(SCF)相关概念-云淘科技

腾讯云对象存储创建模板

使用flink实时写入数据库，并发只能是1，如果并行度加大，就会导致行锁，最后就一直等待？-云小二-阿里云

腾讯云CVM服务器自定义镜像问题

Flink有没有遇到这个？-云小二-阿里云

联系我们

400-800-8888

分享到: