文档中心

对象存储

标签与存储容量配额

GetObjectSetQuota

GetObjectSetQuota

功能描述

此接口用于查询指定 ObjectSet 已配置的存储容量配额（StorageQuota）。

注意事项

ObjectSet 必须存在。

通过子账号使用时，需要授予当前桶的 GetObjectSetQuota 权限。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

请求元素

名称	位置	参数类型	是否必选	示例值	说明
ObjectSetName	Query	String	是	"a/b/c"	需要查询配额的 ObjectSet 名称。说明长度限制为 3 ~ 256 个字符。如果 Bucket 配置了 PathLevel，则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。不允许以自定义分隔符开头。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
StorageQuota	String	"1024"	该 ObjectSet 的存储容量配额，单位为 Byte。未配置时返回空字符串。

请求示例

响应示例

错误码

错误码（Code）	HTTP 状态码	ErrCode	说明
NotAllowObjectSet	403	8301	Bucket 未开启 ObjectSet（BucketObjectSetConfig 未设置）。
ObjectSetNotExist	404	8303	ObjectSet 不存在。
InvalidArgument	400	4014	ObjectSetName 为空或不符合 Bucket 的分隔符与层级约束。
InternalError	500	4004	服务端内部错误（例如：配额配置反序列化失败、底层服务异常）。

最近更新时间：2026.05.21 16:23:30

这个页面对您有帮助吗？

有用

有用

无用

无用