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