全部產品
Search
文件中心

Object Storage Service:list-cloud-boxes

更新時間:Mar 13, 2025

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