put-bucket-requester-qos-info_对象存储(OSS)-阿里云帮助中心

put-bucket-requester-qos-info命令用于修改请求者在Bucket上的流控配置。

注意事项

重要

当前资源池QoS为邀测功能，尚未对所有用户开放使用。如果您在某个地域的OSS性能达到了500Gbps及以上，您可以联系技术支持申请使用。

阿里云账号默认拥有配置存储空间的QoS信息的权限。如果您需要通过RAM用户或者STS的方式进行配置，您必须拥有oss:PutBucketRequesterQoSInfo权限。具体操作，请参见为RAM用户授权自定义的权限策略。
每一项的配置都不能超过Bucket对应的配置。
-1表示不限制，如果有某个字段没有设置，默认为-1；如果设置成0，意味着完全禁止指定类型的访问。
细分项的配置不能超过总项的配置，比如总上传流控配置为10Gbps，那么内网上传流控就不能超过10Gbps。
请求者的流控限制带宽不得低于 5Gbps。例如，上传带宽的限制值必须配置为不低于 5Gbps。
单个Bucket上最多配置300个子账号流控配置。

命令格式

ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=<bucket-name> --parameters requesterQosInfo --parameters qosRequester=<uid> --body file://<path-to-xml>

参数	类型	说明

参数	类型	说明
--bucket	string	Bucket的名称。
--parameters	stringArray	请求的查询参数，采用 k[=v] 格式，如 versionId=123、delete。
--body	string	请求体，file:// 表示从文件读取，- 表示从标准输入读取。

--body

--body配置选项支持XML语法，当选项值包含file://前缀时，表示从文件中读取配置。

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
  <TotalQps>integer</TotalQps>
  <IntranetQps>integer</IntranetQps>
  <ExtranetQps>integer</ExtranetQps>
</QoSConfiguration>

参数	类型	是否必填	示例值	单位	说明

参数	类型	是否必填	示例值	单位	说明
TotalUploadBandwidth	Integer	是	10	Gbps	总上传带宽配置父节点：QoSConfiguration
IntranetUploadBandwidth	Integer	是	-1	Gbps	内网上传带宽配置，包括经典网络内网上传和VPC网络内网上传等等来自于内网的请求父节点：QoSConfiguration
ExtranetUploadBandwidth	Integer	是	-1	Gbps	外网上传带宽配置，包括公网上传以及CDN上传等等来自于外网的请求父节点：QoSConfiguration
TotalDownloadBandwidth	Integer	是	10	Gbps	总下载带宽配置父节点：QoSConfiguration
IntranetDownloadBandwidth	Integer	是	-1	Gbps	内网下载带宽配置，包括经典网络内网下载和VPC网络内网下载等来自于内网的请求，单位Gbps 父节点：QoSConfiguration
ExtranetDownloadBandwidth	Integer	是	-1	Gbps	外网下载带宽配置，包括公网下载以及CDN下载等等来自于外网的请求父节点：QoSConfiguration

说明

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

将 QoS 信息配置到存储空间 examplebucket 中标识为 202835923910178018 的请求者。使用XML配置文件，qos.xml内容如下：

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  <TotalQps>-1</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>

配置参数说明如下：

TotalUploadBandwidth设置为 10，表示上传的总带宽限制为10 Gbps。无论是内网还是外网，所有上传操作的带宽总和不能超过这个值。
IntranetUploadBandwidth设置为 -1，表示对内网的上传带宽不配置任何单独限制，然而，内网上传带宽仍需遵循 TotalUploadBandwidth 设置的总体限制。
ExtranetUploadBandwidth设置为 -1，表示对外网的上传带宽不配置任何单独限制，然而，外网上传带宽仍需遵循 TotalUploadBandwidth 设置的总体限制。
TotalDownloadBandwidth设置为 10，表示下载的总带宽限制为10 Gbps。所有下载操作，不论是内网还是外网，共用这10 Gbps的带宽限制。
IntranetDownloadBandwidth设置为 -1，表示对内网下载带宽不配置任何单独限制，然而，内网下载带宽仍需遵循 TotalDownloadBandwidth设置的总体限制。
ExtranetDownloadBandwidth设置为 -1，表示对外网下载带宽不配置任何单独限制，然而，外网下载带宽仍需遵循 TotalDownloadBandwidth设置的总体限制。
TotalQps、IntranetQps和ExtranetQps均保留默认值-1，表示不限制QPS。

命令示例如下：

ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178018 --body file://qos.xml