Introduction

This interface is used to set tags for a bucket. By setting bucket tags, you can categorize and manage buckets. For example, you can add certain cost tags to the bucket, which will then be included in the billing statements generated by this bucket, enabling detailed classification filtering and more thorough cost analysis of detailed statements.

Precautions

Only the owner of the storage bucket and users with PutBucketTagging permission can create bucket tags.

Tag setting rules

Category	Description
Tag key	Supports letters or characters from any language (such as Chinese, English letters, etc.), numbers, spaces; supports special characters: _.:/=+-@. volc: and sys: are reserved tag keys for the system, the beginning of the tag key cannot be set to any form of volc: or sys: in upper or lower case. The length of the tag key must be between 1 to 128 characters.
Tag value	Supports letters or characters from any language (such as Chinese, English letters, etc.), numbers, spaces; supports special characters: _.:/=+-@. The length of the tag value must be between 0 to 256 characters, meaning the tag value can be empty.
Tag quantity	There is no limit to the total number of tags, but each bucket can have a maximum of 50 tags attached.

Request syntax

Request parameters and headers

The request requires setting the Content-MD5 value of the request element in the message header to compare with the MD5 value of the uploaded request element. If they do not match, an error will be returned. For other common request headers used, please refer to Common parameters.

Name	Location	Type	Required	Sample value	Description
tagging	Query	String	Yes	-	A special identification for the PutBucketTagging request.

Request body elements

Name	Type	Required	Sample value	Description
TagSet	Object	Yes	-	Bucket label collection information.
Tags	Array	Yes	-	Bucket label list information.
Key	String	Yes	owner	Value of the tag key. For specific setting rules, please see Tagging buckets.
Value	String	Yes	zhangsan	Value of the tag value. For specific setting rules, please see Tagging buckets.

Response headers

This request returns the common response message headers, please see Common parameters.

Response body elements

There is no message element in this request response.

Sample request

Sample response

Torch Object Storage