接口描述

此接口用于向指定的object上传对象标签，目前BOS支持两种方式设置对象标签。在PutObjectTagging的时候，通过头域的"x-bce-tagging"来设置object对象标签，第二种方式是上传一个TAG文件。

请求（Request）

• TAG文件请求语法

  Plain Text 复制

  1PUT /<ObjectKey>?tagging HTTP/1.1
  2Host: <BucketName>.bj.bcebos.com
  3x-bce-date: <Date>
  4Authorization: <AuthorizationString>
  5Content-Type: application/json; charset=utf-8
  6Content-Length: <ContentLength>

• Canned TAG请求语法（设置x-bce-tagging）

  Plain Text 复制

  1 PUT /<ObjectKey>?tagging HTTP/1.1
  2 Host: <BucketName>.bj.bcebos.com
  3 x-bce-date: <Date>
  4 x-bce-tagging: <ObjectTag>
  5 Authorization: <AuthorizationString>
  6 Content-Length: <ContentLength>
  7 Content-Type: application/json; charset=utf-8

• 请求参数

  无特殊参数

• 请求头域

  名称	类型	描述	是否必需
  x-bce-tagging	String	用户自定义的对象标签	否

• 请求参数

  无特殊参数

响应（Response）

• 响应头域

  无特殊参数返回

• 响应参数

  无

示例

• 请求示例1

1 PUT /ObjectName?tagging HTTP/1.1
2 Host: BucketName.bj.bcebos.com
3 x-bce-date: 2017-05-01T12:23:49Z
4 x-bce-tagging: bos1=value1&bos2=values2
5 Authorization: AuthorizationString
6 Content-Type: application/json; charset=utf-8
7 Content-Length: 0

• 响应示例

1HTTP/1.1 200 OK
2Date: Wed, 01 Mar 2017 12:25:00 GMT
3Content-Length: 0
4Server: BceBos
5x-bce-request-id:413e34fd-118d-4049-b992-1b1f3a68b1f5

• 请求示例2

1 PUT /ObjectName?tagging HTTP/1.1
2 Host: BucketName.bj.bcebos.com
3 x-bce-date: 2017-05-01T12:23:49Z
4 Authorization: AuthorizationString
5 Content-Type: application/json; charset=utf-8
6 Content-Length: 315
7 {"tagSet":[{"tagInfo":[{"key":"key1","value":"value1"},  {"key":"key2","value":"value2"},{"key":"key3","value":"value3"}]}]} 

• 响应示例

1HTTP/1.1 200 OK
2Date: Wed, 01 Mar 2017 12:25:00 GMT
3Content-Length: 0
4Server: BceBos
5x-bce-request-id:413e34fd-118d-4049-b992-1b1f3a68b1f5