put-resource-pool-bucket-group-qos-info命令用于配置或修改资源池中BucketGroup的流控信息。
注意事项
当前资源池QoS为邀测功能。您在某个地域的OSS性能达到400 Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有配置资源池中BucketGroup的流控信息的权限。如果您需要通过RAM用户或者STS的方式进行配置，您必须拥有oss:PutResourcePoolBucketGroupQoSInfo权限。具体操作，请参见为RAM用户授予自定义的权限策略。
命令格式
ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePool=<resource-pool> --parameters resourcePoolBucketGroup=<GroupName> --parameters resourcePoolBucketGroupQosInfo --body=file://<path-to-xml>|
参数 |
类型 |
说明 |
|
--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>-
以下带宽配置项中，取值为-1（默认值）表示不限制带宽。取值为0，表示禁止该类型的带宽，例如ExtranetUploadBandwidth取值为0，表示禁止通过外网上传数据到指定Bucket。
-
BucketGroup带宽配置总和不能超过资源池总的带宽配置。BucketGroup单项带宽配置不能超过总的带宽配置。例如，总下载带宽配置为10Gbps，则外网下载带宽不能超过10Gbps。
-
BucketGroup单项带宽配置不能低于5Gbps。
|
参数 |
类型 |
是否必填 |
示例值 |
单位 |
说明 |
|
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 |
|
TotalQps |
Integer |
是 |
10000 |
次/秒 |
总QPS配置 父节点：QoSConfiguration |
|
IntranetQps |
Integer |
是 |
-1 |
次/秒 |
内网QPS配置，包括经典网络内网和VPC网络内网等来自于内网的请求 父节点：QoSConfiguration |
|
ExtranetQps |
Integer |
是 |
-1 |
次/秒 |
外网QPS配置，包括公网以及CDN等来自于外网的请求 父节点：QoSConfiguration |
关于支持的全局命令行选项，请参见支持的全局命令行选项。
使用示例
将指定的 QoS 信息应用到资源池 examplePool 中名为 exampleGroup 的BucketGroup，使用XML配置文件，qos.xml 的内容如下：
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
<TotalQps>10000</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设置为 10000，表示总QPS限制为10000次/秒。无论是内网还是外网，所有请求的QPS总和不能超过这个值。
-
IntranetQps设置为 -1，表示对内网的QPS不配置任何单独限制，然而，内网QPS仍需遵循 TotalQps 设置的总体限制。
-
ExtranetQps设置为 -1，表示对外网的QPS不配置任何单独限制，然而，外网QPS仍需遵循 TotalQps 设置的总体限制。
命令示例如下：
ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePool=examplePool --parameters resourcePoolBucketGroup=exampleGroup --parameters resourcePoolBucketGroupQosInfo --body=file://qos.xml