调用 PutObjectTagging 接口为对象(Object)设置和更新标签(Tag)信息。
如果您的存储桶开启了版本控制功能,调用 PutObjectTagging 接口时,存在以下限制:
versionId
参数,指定需要设置的对象版本的标签信息。404 Not Found
。类别 | 注意事项 |
---|---|
接口 | 使用 PutObjectTagging 接口设置标签时,存在以下两种情况:
|
标签 |
|
标签的键值对 |
|
PUT /objectname?tagging Content‐Length: 114 Host: Host: examplebucket.tos.cn-beijing.com Date: Mon, 18 Mar 2019 08:25:17 GMT Authorization: SignatureValue { "TagSet": { "Tags": [ { "Key": "aa", "Value": "bb" }, { "Key": "bb", "Value": "cc" } ] } }
使用公共请求消息头。更多信息,请参见公共参数。
参数名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|---|
tagging | Query | String | 是 | - | 只需设置参数名称,无需设置参数值,代表 PutObjectTagging 请求的特殊标识。 |
versionId | Query | String | 否 | 57894830D7822B2ACB78 | 对象的版本号,用于标识设置指定版本的对象标签。 |
参数名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|
TagSet | Container | 是 | - | 标签信息集合。 |
Tags | Container | 是 | - | 标签信息。 |
Key | String | 是 | aa | 设置标签键。 |
Value | String | 否 | bb | 设置标签值。 |
返回公共响应消息头。更多信息,请参见公共参数。
该请求响应中无消息元素。
PUT /objectname?tagging Content‐Length: 114 Host: bucketname.tos.cn-beijing.com Date: Mon, 18 Mar 2019 08:25:17 GMT Authorization: SignatureValue { "TagSet": { "Tags": [ { "Key": "aa", "Value": "bb" }, { "Key": "bb", "Value": "cc" } ] } }
PUT /objectname?tagging&versionId=57894830D7822B2ACB78 Content‐Length: 114 Host: bucketname.tos.cn-beijing.com Date: Mon, 18 Mar 2019 08:25:17 GMT Authorization: SignatureValue { "TagSet": { "Tags": [ { "Key": "aa", "Value": "bb" }, { "Key": "bb", "Value": "cc" } ] } }
HTTP/1.1 200 OK content-length: 0 server: TosServer date: Wed, 24 Jun 2020 08:57:15 GMT x-tos-id-2: 4fac130bedb6002c-a444ed0 x-tos-request-id: 4fac130bee03002e-a444ed0
HTTP/1.1 200 OK content-length: 0 server: TosServer date: Wed, 24 Jun 2020 08:58:15 GMT x-tos-id-2: ea2ceb08a4e30021-a444ed0 x-tos-request-id: 5726ce090a2d002d-a444ed0 x-tos-version-id: 57894830D7822B2ACB78