list-cloud-boxes

list-cloud-boxes命令用于列举当前阿里云账号下关联的云盒信息。

注意事项

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

命令格式

ossutil api list-cloud-boxes [flags]

参数

类型

说明

--marker 

string

指定云盒返回的存储空间的名称。

--max-keys

int

指定返回的云盒的最大数量。

--prefix

string

指定返回的云盒名称必须包含的前缀。

说明

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

使用示例

  • 列出请求者云账号下的所有云盒。

    ossutil api list-cloud-boxes
  • 列出请求者云账号下的所有云盒,以JSON格式显示。

    ossutil api list-cloud-boxes --output-format json
  • 列出请求者云账号下的所有云盒,以YAML格式显示。

    ossutil api list-cloud-boxes --output-format yaml
  • 列出请求者云账号下的所有前缀为example的云盒。

    ossutil api list-cloud-boxes --prefix example
  • 列出请求者云账号下的前10个云盒。

    ossutil api list-cloud-boxes --max-keys 10
  • 列出请求者云账号下指定标记example后的所有云盒。

    ossutil api list-cloud-boxes --marker example