You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储API 参考存储桶ObjectSet基础操作GetObjectSet
复制全文
下载 pdf
我的收藏
基础操作
GetObjectSet
复制全文
下载 pdf
我的收藏
GetObjectSet
功能描述​
此接口用于查询指定 ObjectSet 的基础信息和标签。​
注意事项​
  • 如果该 ObjectSet 不存在，接口将返回 ObjectSetNotExist 错误。​
  • 通过子账号使用时，需要授予当前桶的 GetObjectSet 权限。​
请求消息样式​
​
Get /?objectset&ObjectSetName=a/b/c HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
请求参数和消息头​
该请求使用的公共请求消息头，请参见公共参数。​
请求元素​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
ObjectSetName​
Query​
String​
是​
"a/b/c/"​
本次查询 ObjectSet 的名称。​
说明​
  • 长度限制为 3 ~ 256 个字符。​
  • 如果 Bucket 配置了 PathLevel，则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。​
  • 不允许以自定义分隔符开头。​
​
响应消息头​
该请求使用的公共请求消息头，请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
ObjectSetName​
String​
"a/b/c/"​
查询 ObjectSet 的名称。​
TagSet​
Container​
-​
标签信息集合。​
Tags​
Container​
-​
标签信息。​
Key​
String​
aa​
标签的键。​
Value​
String​
bb​
标签的值。​
​
请求示例​
​
GET /?objectset&ObjectSetName=a/b/c/ HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
响应示例​
​
HTTP/1.1 200 OK​
Content-Type: application/json​
​
{​
"ObjectSetName": "a/b/c/",​
"TagSet": {​
"Tags": [​
{"Key": "owner", "Value": "zhangsan"}​
]​
}​
}​
​
最近更新时间：2026.05.21 16:23:30
这个页面对您有帮助吗？
有用
有用
无用
无用