put-bucket-qos-info - 对象存储 OSS

put-bucket-qos-info命令用于配置某个存储空间（Bucket）的QoS信息。

注意事项

重要

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

阿里云账号默认拥有配置存储空间的QoS信息的权限。如果您需要通过RAM用户或者STS的方式进行配置，您必须拥有oss:PutBucketQoSInfo权限。具体操作，请参见为RAM用户授权自定义的权限策略。
只有加入资源池中的Bucket，才允许配置其流控信息，且每一项的配置都不能超过资源池对应的配置。
-1表示不限制，如果有某个字段没有设置，默认为-1；如果设置成0，意味着完全禁止指定类型的访问。
另外细分项的配置不能超过总项的配置，比如总上传流控配置为10Gbps，那么内网上传流控就不能超过10Gbps。

命令格式

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

参数	类型	说明
--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>
</QoSConfiguration>

说明

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

使用示例

将 QoS 信息配置应用到名为 examplebucket 的存储空间。使用XML配置文件，qos.xml内容如下：

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

命令示例如下：

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