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

对象存储

复制全文
下载 pdf
ObjectSet
GetObjectSetEndPoint
复制全文
下载 pdf
GetObjectSetEndPoint
功能描述​
此接口用于查询指定 ObjectSet 在已启用 ObjectSet 规则的融合型接入点下生成的访问域名,包括 TOS 协议域名和 S3 协议域名。​
注意事项​
  • ObjectSet 必须存在,否则接口将返回 ObjectSetNotExist 错误。​
  • GetObjectSetEndPoint 仅返回 CAP ObjectSet 规则状态为 Enabled 的接入点。​
  • 通过子账号使用时,需要授予当前桶的 GetObjectSetEndPoint 权限。​
请求消息样式​
​
GET /?objectsetendpoint&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/"​
需要查询 Endpoint 的 ObjectSet 名称。​
说明​
  • 长度限制为 3 ~ 256 个字符。​
  • 如果 Bucket 配置了 PathLevel,则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。​
  • 不允许以自定义分隔符开头。​
​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
capname​
String​
cap-example-id​
CAP 名称,若 CAP 名称为空则为 CapID。​
endpoint​
String[]​
myalias-objset-cap-example-id.tos-cn-beijing.volces.com​
TOS 协议访问域名列表。​
s3endpoint​
String[]​
myalias-objset-cap-example-id.s3-tos-cn-beijing.volces.com​
S3 协议访问域名列表。​
​
请求示例​
​
GET /?objectsetendpoint&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​
​
[​
{​
"capname": "cap-example-id",​
"endpoint": [​
"myalias-objset-cap-example-id.tos-cn-beijing.volces.com"​
],​
"s3endpoint": [​
"myalias-objset-cap-example-id.s3-tos-cn-beijing.volces.com"​
]​
}​
]​
​
​
最近更新时间:2026.07.06 11:55:15
这个页面对您有帮助吗?
有用
有用
无用
无用