全部文档
当前文档

暂无内容

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

文档中心

GET Requester Qos

最近更新时间:2026-01-20 15:08:22

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

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

请求

请求语法

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

请求参数

该接口不使用请求参数。

请求头部

该接口仅使用公共请求头

请求内容

该接口不使用请求内容。

响应

响应头部

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

响应内容

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

名称

描述

RequesterQosConfiguration

请求者流控配置的容器。

Rule

存放单条规则的容器,支持配置多条规则。

  • 父节点:RequesterQosConfiguration

UserType

请求者类型。

  • 取值:User/Role,User表示对子账号限流,Role表示对角色限流

  • 父节点:Rule

Krn

请求者详情,仅支持设置当前账号下的子账号或角色请求限流。

  • 父节点:Rule

1. 子账号格式:账号UID/子账号名称。

2. 角色格式:账号UID/角色名称。

Quota

设置具体流控配额信息的容器。

  • 父节点:Rule

StorageMedium

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

  • 取值:固定取值Normal

  • 父节点:Quota

ExtranetUploadBandwidth

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

  • 父节点:Quota

IntranetUploadBandwidth

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

  • 父节点:Quota

ExtranetDownloadBandwidth

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

  • 父节点:Quota

IntranetDownloadBandwidth

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

  • 父节点:Quota

示例

请求示例

GET /?requesterqos 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 12:23:54 GMT
Server: KS3
x-kss-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****

<?xml version="1.0" encoding="UTF-8"?>
<RequesterQosConfiguration>
    <Rule>
        <UserType>User</UserType>
        <Krn>200000/userName1</Krn>
        <Quota>
            <StorageMedium>Normal</StorageMedium>
            <ExtranetUploadBandwidth>1000</ExtranetUploadBandwidth>
            <IntranetUploadBandwidth>1000</IntranetUploadBandwidth>
            <ExtranetDownloadBandwidth>1000</ExtranetDownloadBandwidth>
            <IntranetDownloadBandwidth>1000</IntranetDownloadBandwidth>
        </Quota>
    </Rule>
</RequesterQosConfiguration>

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

纯净模式

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