简介
本文档提供关于对象标签的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
设置对象标签 | 为已存在的对象设置标签 | |
查询对象标签 | 查询指定对象下已有的对象标签 | |
删除对象标签 | 删除指定的对象标签 |
设置对象标签
功能说明
为已存在的对象设置标签。
请求示例
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);});
参数说明
回调函数说明
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": {}}
参数说明
回调函数说明
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);});
参数说明
回调函数说明
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
