GetBucketQoSInfo_对象存储(OSS)-阿里云帮助中心

调用GetBucketQoSInfo接口获取Bucket流控配置。

注意事项

当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有获取资源池内指定Bucket流控配置的权限。如果您需要通过RAM用户或者STS的方式进行获取，您必须拥有oss:GetBucketQoSInfo权限。具体操作，请参见RAM Policy常见示例。

请求语法

GET /?qosInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称	类型	示例值	描述

名称	类型	示例值	描述
QoSConfiguration	容器	不涉及	保存请求结果的容器。父节点：无
TotalUploadBandwidth	整数	10	Bucket的总上传带宽，单位Gbps。父节点：QoSConfiguration
IntranetUploadBandwidth	整数	-1	Bucket的内网上传带宽，包括经典网络和VPC网络的内网上传带宽，单位Gbps。父节点：QoSConfiguration
ExtranetUploadBandwidth	整数	-1	Bucket的外网上传带宽，包括公网和传输加速域名的上传带宽，单位Gbps。父节点：QoSConfiguration
TotalDownloadBandwidth	整数	10	Bucket的总下载带宽，单位Gbps。父节点：QoSConfiguration
IntranetDownloadBandwidth	整数	-1	Bucket的内网下载带宽，包括经典网络和VPC网络的内网下载带宽，单位Gbps。父节点：QoSConfiguration
ExtranetDownloadBandwidth	整数	-1	Bucket的外网下载带宽，包括公网和传输加速域名的下载带宽，单位Gbps。父节点：QoSConfiguration

示例

请求示例

Get /?qosInfo HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com   
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS qn6q****:77Dv****

返回示例

HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 534****

<?xml version="1.0" encoding="UTF-8"?>
<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

命令行工具ossutil

GetBucketQoSInfo接口所对应的ossutil命令，请参见get-bucket-qos-info。