## **功能描述** 此接口用于查询指定 ObjectSet 已配置的存储容量配额（`StorageQuota`）。 ## **注意事项** 1. ObjectSet 必须存在。 2. 通过子账号使用时，需要授予当前桶的 `GetObjectSetQuota `权限。 ## **请求消息样式** ```JSON GET /?objectsetquota&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?)。 ## **响应元素** |名称 |参数类型 |示例值 |说明 | |---|---|---|---| |StorageQuota |String |"1024" |该 ObjectSet 的存储容量配额，单位为 Byte。未配置时返回空字符串。 | ## **请求示例** ```JSON GET /?objectsetquota&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 { "StorageQuota": "1024" } ``` ## 错误码 |错误码（Code） |HTTP 状态码 |ErrCode |说明 | |---|---|---|---| |NotAllowObjectSet |403 |8301 |Bucket 未开启 ObjectSet（`BucketObjectSetConfig `未设置）。 | |ObjectSetNotExist |404 |8303 |ObjectSet 不存在。 | |InvalidArgument |400 |4014 |`ObjectSetName` 为空或不符合 Bucket 的分隔符与层级约束。 | |InternalError |500 |4004 |服务端内部错误（例如：配额配置反序列化失败、底层服务异常）。 |

对象存储