GetBucketTagging--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

GetBucketTagging

最近更新时间：2024.08.01 20:30:32首次发布时间：2023.11.21 10:22:23

功能描述

此接口用于获取指定存储桶的标签信息。

注意事项

只有存储桶的拥有者以及拥有 GetBucketTagging 权限的用户才能获取桶标签。

请求消息样式

GET /?tagging HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
tagging	Query	String	是	-	代表 GetBucketTagging 请求的特殊标识。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	是否必选	示例值	说明
TagSet	Object	是	-	桶标签集合信息。
Tags	Array	是	-	桶标签列表信息。
Key	String	是	owner	标签 Key 的值。具体设置规则，请参见设置桶标签。
Value	String	是	zhangsan	标签 Value 的值。具体设置规则，请参见设置桶标签。

请求示例

GET /?tagging HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

响应示例

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"
                }]
        }
}