list-resource-pools

list-resource-pools用于列举主账号在当前地域下的资源池。

注意事项

重要

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

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

  • 资源池属于特定地域,列举操作只能列举出域名对应地域的资源池。

命令格式

ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]

参数

类型

说明

--bucket

string

Bucket的名称。

--parameters

stringArray

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

--body

string

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

说明

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

使用示例

  • 列举当前主账号下所有可用的资源池信息,命令示例如下:

    ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool
  • 列出资源池的信息,此请求从存储空间标识为 examplebucket 的位置开始获取数据,并限制返回的最大条目数为 1。命令示例如下:

    ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool --parameters continuation-token=examplebucket --parameters max-keys=1