## **功能描述** 此接口用于查询指定 ObjectSet 的基础信息和标签。 ## **注意事项** * 如果该 ObjectSet 不存在，接口将返回 `ObjectSetNotExist `错误。 * 通过子账号使用时，需要授予当前桶的 `GetObjectSet `权限。 ## **请求消息样式** ```JSON Get /?objectset&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/" |本次查询 ObjectSet 的名称。

说明

*

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

*

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

*

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

| ## **响应消息头** 该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044?)。 ## **响应元素** |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |ObjectSetName |String |"a/b/c/" |查询 ObjectSet 的名称。 | |TagSet |Container |\- |标签信息集合。 | |Tags |Container |\- |标签信息。 | |Key |String |aa |标签的键。 | |Value |String |bb |标签的值。 | ## **请求示例** ```JSON GET /?objectset&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 { "ObjectSetName": "a/b/c/", "TagSet": { "Tags": [ {"Key": "owner", "Value": "zhangsan"} ] } } ```

对象存储