金山云-文档中心-GET Bucket Quota

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

空间配额（Quota）

GET Bucket Quota

最近更新时间：2026-06-17 12:07:47



该接口用于获取桶配额规则，调用该接口的用户必须是主账号或具有ks3:GetBucketQuota权限。

请求

请求语法

GET /?quota HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

请求参数

该接口不使用请求参数。

请求头

该接口仅使用常用请求头部。

请求体

该接口不使用请求体。

响应

响应头

该接口仅返回常用响应头部。

响应体

返回XML格式的响应体，响应体元素如下所示：

名称	说明
Quota	包含桶配额相关规则的容器。子节点：StorageQuota
StorageQuota	指定桶配额值，单位为字节。取值范围：1~9223372036854775807 类型：Integer 父节点：Quota
Day	指定桶每天流量或请求次数可用配额值。类型：Container 父节点：Quota
Month	指定桶每月流量或请求次数可用配额值。类型：Container 父节点：Quota
IntranetFlowUp	指定桶内网上行流量配额值，单位为字节，取值必须为正整数。取值范围：1~9223372036854775807 类型：Integer 父节点：Day/Month
IntranetFlowDown	指定桶内网下行流量配额值，单位为字节，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
ExtranetFlowUp	指定桶外网上行流量配额值，单位为字节，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
ExtranetFlowDown	指定桶外网下行流量配额值，单位为字节，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
CDNFlowUp	指定桶CDN上行流量配额值，单位为字节，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
CDNFlowDown	指定桶CDN下行流量配额值，单位为字节，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
Put	指定桶PUT类请求次数配额值（包含PUT、POST、DELETE请求），单位为次，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
Get	指定桶GET类请求次数配额值（包含GET、HEAD请求），单位为次，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month
List	指定桶List请求次数配额值，单位为次，取值必须为正整数。取值范围为1~9223372036854775807 类型：Integer 父节点：Day/Month

示例

请求示例

GET /?quota HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2016 12:00:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Connection: keep-alive
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: KS3
x-kss-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****

<?xml version="1.0" encoding="UTF-8"?>
<Quota>
    <StorageQuota>10240000</StorageQuota>
    <Day>
        <IntranetFlowUp>10240000</IntranetFlowUp>
        <IntranetFlowDown>10240000</IntranetFlowDown>
        <ExtranetFlowUp>10240000</ExtranetFlowUp>
        <ExtranetFlowDown>10240000</ExtranetFlowDown>
        <CDNFlowUp>10240000</CDNFlowUp>
        <CDNFlowDown>10240000</CDNFlowDown>
        <Put>10240000</Put>
        <Get>10240000</Get>
        <List>10240000</List>
    </Day>
    <month>
        <IntranetFlowUp>10240000</IntranetFlowUp>
        <IntranetFlowDown>10240000</IntranetFlowDown>
        <ExtranetFlowUp>10240000</ExtranetFlowUp>
        <ExtranetFlowDown>10240000</ExtranetFlowDown>
        <CDNFlowUp>10240000</CDNFlowUp>
        <CDNFlowDown>10240000</CDNFlowDown>
        <Put>10240000</Put>
        <Get>10240000</Get>
        <List>10240000</List>
    </month>
</Quota>

错误码

HTTP 状态码	错误码	描述
404 Not Found	NoSuchBucketQuota	桶配额规则不存在。
400 Bad Request	InvalidRequest	请求不合法。
403 Forbidden	AccessDenied	缺少权限。
404 Not Found	NoSuchBucket	桶不存在。

文档导读

上一篇：PUT Bucket Quota

下一篇：DELETE Bucket Quota

纯净模式常规模式

纯净模式

点击可全屏预览文档内容