## **功能描述** 此接口用于查询指定 ObjectSet 在已启用 ObjectSet 规则的融合型接入点下生成的访问域名，包括 TOS 协议域名和 S3 协议域名。 ## 注意事项 * ObjectSet 必须存在，否则接口将返回 `ObjectSetNotExist `错误。 * GetObjectSetEndPoint 仅返回 CAP ObjectSet 规则状态为 `Enabled `的接入点。 * 通过子账号使用时，需要授予当前桶的 `GetObjectSetEndPoint `权限。 ## **请求消息样式** ```JSON GET /?objectsetendpoint&ObjectSetName=a/b/c/ HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## **请求参数和消息头** 该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044?)。 ## **请求元素** |名称 |位置 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---|---| |ObjectSetName |query |String |是 |"a/b/c/" |需要查询 Endpoint 的 ObjectSet 名称。

说明

*

长度限制为 3 ~ 256 个字符。

*

如果 Bucket 配置了 PathLevel，则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。

*

不允许以自定义分隔符开头。

| ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044?)。 ## **响应元素** |名称 |参数类型 |示例值 |说明 | |---|---|---|---| |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 协议访问域名列表。 | ## **请求示例** ```JSON GET /?objectsetendpoint&ObjectSetName=a/b/c/ HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## **响应示例** ```JSON 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" ] } ] ```

对象存储