list-objects-v2命令用於列舉儲存空間(Bucket)中所有檔案(Object)的資訊。
注意事項
阿里雲帳號預設擁有列舉Bucket中的所有檔案的資訊。如果您需要通過RAM使用者或者STS的方式進行查看,您必須擁有
oss:ListObjects許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。執行list-objects-v2(get-bucket-v2)請求時不會返回Object中自訂的元資訊。
命令格式
ossutil api list-objects-v2 --bucket value [flags]參數 | 類型 | 說明 |
--bucket | string | Bucket的名稱。 |
--continuation-token | string | 指定list操作需要從此token開始。 |
--delimiter | string | 對Object名字進行分組的字元。 |
--encoding-type | string | 對返回的內容進行編碼並指定編碼的類型。 |
--fetch-owner | string | 指定是否在返回結果中包含owner資訊。 |
--max-keys | int | 指定返回Object的最大數。 |
--prefix | string | 限定返迴文件的Key必須以Prefix作為首碼。 |
--start-after | string | 設定從start-after之後按字母排序開始返回Object |
list-objects-v2(get-bucket-v2)命令對應API介面ListObjectsV2(GetBucketV2)。關於API中的具體參數含義,請參見ListObjectsV2(GetBucketV2)。
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
以下樣本展示了如何列舉儲存空間examplebucket中所有Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket以下樣本展示了如何列舉儲存空間examplebucket中所有Object的資訊,以JSON格式顯示。
ossutil api list-objects-v2 --bucket examplebucket --output-format json以下樣本展示了如何列舉儲存空間examplebucket中所有Object的資訊,以YAML格式顯示。
ossutil api list-objects-v2 --bucket examplebucket --output-format yaml以下樣本展示了如何列舉儲存空間examplebucket中指定首碼dir下的所有Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir以下樣本展示了如何列舉儲存空間examplebucket中指定首碼dir下,前100個Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir --max-keys 100以下樣本展示了如何列舉儲存空間examplebucket中目前的目錄下的Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket --delimiter /以下樣本展示了如何列舉儲存空間examplebucket中指從test.txt之後的Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket --start-after test.txt以下樣本展示了如何列舉儲存空間examplebucket中所有Object的資訊,並對Object的名字進行URL編碼。
ossutil api list-objects-v2 --bucket examplebucket --encoding-type url以下樣本展示了如何列舉儲存空間examplebucket 中所有Object的資訊,並返回結果中包含owner資訊。
ossutil api list-objects-v2 --bucket examplebucket --fetch-owner以下樣本展示了如何列舉儲存空間examplebucket 中,從CgJiYw123 開始的所有Object的資訊。
ossutil api list-objects-v2 --bucket examplebucket --continuation-token CgJiYw123