list-bucket-requester-qos-infos

list-bucket-requester-qos-infos用于列举所有在某个存储空间(Bucket)上的请求者流控配置。

注意事项

重要

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

  • 阿里云账号默认拥有列举存储空间的QoS信息的权限。如果您需要通过RAM用户或者STS的方式进行列举,您必须拥有oss:ListBucketRequesterQoSInfos权限。具体操作,请参见RAM用户授权自定义的权限策略

命令格式

ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket <bucket-name> --parameters requesterQosInfo [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]

参数

类型

说明

--bucket

string

Bucket的名称。

--parameters

stringArray

请求的查询参数,采用 k[=v] 格式,如 versionId=123、delete。

--body

string

请求体,file:// 表示从文件读取,- 表示从标准输入读取。

说明

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

使用示例

  • 列出存储空间 examplebucket 中所有的请求者QoS信息,命令示例如下:

    ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket examplebucket --parameters requesterQosInfo
  • 列出存储空间examplebucket中的 QoS 信息,从请求者标识202835923910178018开始,并限制返回的最大条目数为 2,命令示例如下:

    ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket examplebucket --parameters requesterQosInfo --parameters continuation-token=202835923910178018 --parameters max-keys=2