全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

GET Bucket Qos

最近更新时间:2026-01-20 15:07:35

该接口用于获取桶的带宽限流规则,使用该接口的用户,必须是桶拥有者或具有ks3:GetBucketQos权限。

如需为子用户配置ks3:GetBucketQos权限,请在IAM控制台新建权限策略后(通过策略语法的方式),为子用户添加策略。

请求

请求语法

GET /?bucketqos HTTP/1.1
Host: {bucket}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5}

请求参数

该接口不使用请求参数。

请求头部

该接口仅使用公共请求头

请求内容

该接口不使用请求内容。

响应

响应头部

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

响应内容

返回XML中的参数如下所示:

名称

描述

BucketQosConfiguration

桶流控配置的容器。

Quota

设置流控配额的容器。

  • 父节点:BucketQosConfiguration

StorageMedium

指定需要配置流控规则的存储介质类型。

  • 取值:固定取值Normal

  • 父节点:Quota

ExtranetUploadBandwidth

外网上传带宽,单位为Gbps,值必须是正整数。

  • 父节点:Quota

IntranetUploadBandwidth

内网上传带宽,单位为Gbps,值必须是正整数。

  • 父节点:Quota

ExtranetDownloadBandwidth

外网下行带宽,单位为 Gbps,值必须是正整数。

  • 父节点:Quota

IntranetDownloadBandwidth

内网下行带宽,单位为 Gbps,值必须是正整数。

  • 父节点:Quota

示例

请求示例

GET /?bucketqos HTTP/1.1
Host: {bucket}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5}

响应示例

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

<BucketQosConfiguration>
    <Quota>
      <StorageMedium>Normal</StorageMedium>
      <OccupyExtranetUploadBandwidth>1000</OccupyExtranetUploadBandwidth>
      <OccupyIntranetUploadBandwidth>1000</OccupyIntranetUploadBandwidth>
      <OccupyExtranetDownloadBandwidth>1000</OccupyExtranetDownloadBandwidth>
      <OccupyIntranetDownloadBandwidth>1000</OccupyIntranetDownloadBandwidth>
    </Quota>
</BucketQosConfiguration>

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈