Feature

This API is used to set tags on an existing object. It can help you group and manage existing object resources by adding key-value pairs as object tags. For more information, see Object Tagging Overview.

To call this API using a sub-account, please make sure that you have obtained permissions for this API from the root account.

Currently, you can set up to 10 different tags on one object. If you set more, COS will replace the existing tags with new ones.

Versioning

When versioning is enabled for your bucket, you can include VersionId in your request to add object tags to the specified version of an object.

Request

Sample request

PUT /<ObjectKey>tagging&VersionId=VersionId HTTP 1.1
Host:<BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

Authorization: Auth String (see Request Signature for more information)

Request parameters

Request headers

This API uses only common request headers. For more information, see Common Request Headers.

Request body

For this request, you need to configure the following set of tags:

<?xml version="1.0" encoding="UTF-8" ?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
  </TagSet>
</Tagging>

The nodes are described in details below:

Response

Response headers

This API returns common response headers. For more information, see Common Response Headers.

Response body

The response body is empty.

Error codes

This API returns uniform error responses and error codes. For more information, see Error Codes.

Samples

Request

The following request writes two tags {age:18} and {name:xiaoming} to the bucket examplebucket-1250000000. COS successfully configures the tags and returns 204 (success).

PUT /exampleobject.txt?tagging HTTP/1.1
User-Agent: curl/7.29.0
Accept: */*
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Authorization: Auth String
Content-Length: 127
Content-MD5:MD5 String
Content-Type: application/xml

<Tagging>
    <TagSet>
        <Tag>
            <Key>age</Key>
            <Value>18</Value>
        </Tag>
        <Tag>
            <Key>name</Key>
            <Value>xiaoming</Value>
        </Tag>
    </TagSet>
</Tagging>

Response

HTTP/1.1 204 No Content
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Fri, 19 Jan 2020 11:40:22 GMT
Server: tencent-cos
x-cos-request-id: NWE2MWQ5MjZfMTBhYzM1MGFfMTA5ODVfMTVj****