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