文档中心

对象存储

标签与存储容量配额

PutObjectSetQuota

PutObjectSetQuota

功能描述

此接口用于为指定 ObjectSet 设置存储容量配额。

注意事项

ObjectSet 必须存在。

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

请求消息样式

请求参数和消息头

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

请求元素

名称	位置	参数类型	是否必选	示例值	说明
ObjectSetName	Query	String	是	"a/b/c"	需要设置配额的 ObjectSet 名称。说明长度限制为 3 ~ 256 个字符。如果 Bucket 配置了 PathLevel，则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。不允许以自定义分隔符开头。
StorageQuota	Body	String	是	"1024"	ObjectSet 存储容量配额，单位为 Byte。如果不设置或取值为 0，则表示不限制。取值范围为 [0, 2^63-1]。

响应消息头

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

响应元素

该请求响应中无消息元素，请参见公共参数。

请求示例

响应示例

错误码

错误码（Code）	HTTP 状态码	ErrCode	说明
NotAllowObjectSet	403	8301	Bucket 未开启 ObjectSet（BucketObjectSetConfig 未设置）。
ObjectSetNotExist	404	8303	ObjectSet 不存在。
InvalidArgument	400	4014	参数非法： ObjectSetName 为空/不符合 Bucket 的分隔符与层级约束 StorageQuota 非法（小于 0 或大于 2^63-1）
MissingRequestBodyError	400	4086	请求体为空。
InvalidBody	400	4018	读取请求体失败。
MalformedBody	400	4070	请求体不是合法 JSON，或不符合 Schema。

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

这个页面对您有帮助吗？

有用

有用

无用

无用