You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
Bucket Tag
GetBucketTagging
Copy page
Download PDF
GetBucketTagging
Description​
This interface is used to obtain the tagging information of a specified bucket.​
Precautions​
Only the owner of the bucket and users with GetBucketTagging permission can retrieve bucket tags.​
Request syntax​
​
GET /?tagging HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
Request parameters and headers​
For common request headers, see Common parameters.​
​
Name​
Location​
Type​
Required​
Sample value​
Description​
tagging​
Query​
String​
Yes​
-​
Represents the special identifier of the GetBucketTagging request.​
​
Request body elements​
This request does not use message elements.​
Response headers​
The response includes a common response message header, please see Common parameters.​
Response body elements​
​
Name​
Type​
Required​
Sample value​
Description​
TagSet​
Object​
Yes​
-​
Bucket tag set information.​
Tags​
Array​
Yes​
-​
Bucket tag list information.​
Key​
String​
Yes​
owner​
The value of the tag Key. For specific setting rules, please refer to Setting bucket tags.​
Value​
String​
Yes​
zhangsan​
Value of the label. For specific setting rules, please see Setting bucket tags.​
​
Request example​
​
GET /?tagging HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
Response example​
​
HTTP/1.1 200 OK​
Date: Sat, 07 Oct 2023 09:02:23 GMT​
Server: TosServer​
x-tos-id-2: 1e89f203jld00006-a444fd0​
x-tos-request-id: 1e89f203b2d00006-a444ed0​
Content-Length: 262​
​
{​
"TagSet": {​
"Tags": [{​
"Key": "key1",​
"Value": "value1"​
}, {​
"Key": "key2",​
"Value": "value2"​
}]​
}​
}​
​
​
Last updated: 2026.08.03 10:29:23