全部产品
Search
文档中心

对象存储 OSS:put-resource-pool-requester-qos-info

更新时间:Dec 17, 2024

put-resource-pool-requester-qos-info命令用于配置子账号在资源池的请求者流控信息。

注意事项

重要

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

  • 阿里云账号默认拥有配置资源池的请求者流控信息的权限。如果您需要通过RAM用户或者STS的方式进行配置,您必须拥有oss:PutResourcePoolRequesterQoSInfo权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 每一项的配置都不能超过Bucket对应的配置。

  • -1表示不限制,如果有某个字段没有设置,默认为-1;如果设置成0,意味着完全禁止指定类型的访问。

  • 细分项的配置不能超过总项的配置,比如总上传流控配置为10Gbps,那么内网上传流控就不能超过10Gbps。

  • 请求者流控限制带宽不能低于5Gbps。

  • 单个Bucket上最多配置300个子账号流控配置。

命令格式

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=<resource-pool> --parameters qosRequester=<uid> --parameters requesterQosInfo --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>
说明

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

使用示例

将指定的 QoS 信息应用到资源池 examplePool 中标识为 202835923910178019 的请求者。使用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>

命令示例如下:

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=examplePool --parameters qosRequester=202835923910178019 --parameters requesterQosInfo --body=file://qos.xml