list-object-versions命令用於列出Bucket中包括刪除標記(Delete Marker)在內的所有Object的版本資訊。
注意事項
要列出Object的版本資訊,您必須有oss:ListObjectVersions許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。
命令格式
ossutil api list-object-versions --bucket value [flags]參數 | 類型 | 說明 |
--bucket | string | Bucket名稱。 |
--delimiter | string | 對Object名字進行分組的字元。 |
--encoding-type | string | 對返回的內容進行編碼並指定編碼類別型。 |
--key-marker | string | 設定結果從key-marker之後按字母序開始返回,與version-id-marker組合使用。 |
--max-keys | int | 限定此次返回Object的最大個數。 |
--prefix | string | 限定返回的Object Key必須以prefix作為首碼。 |
--version-id-marker | string | 設定結果從key-marker對象的version-id-marker之後按新舊版本排序開始返回。 |
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
列舉儲存空間examplebucket中所有Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket列舉儲存空間examplebucket中所有Object的版本資訊,以JSON格式顯示。
ossutil api list-object-versions --bucket examplebucket --output-format json列舉儲存空間examplebucket中所有Object的版本資訊,以YAML格式顯示。
ossutil api list-object-versions --bucket examplebucket --output-format yaml列舉儲存空間examplebucket下,指定首碼dir下的所有Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket --prefix dir列舉儲存空間examplebucket下,指定首碼dir下,前100個Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100列舉儲存空間examplebucket下,目前的目錄下的所有Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket --delimiter /列舉儲存空間examplebucket下,從test.txt之後的所有Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt列舉儲存空間examplebucket中所有Object的版本資訊,並對對象名字進行URL編碼。
ossutil api list-object-versions --bucket examplebucket --encoding-type url列舉儲存空間examplebucket下,從test.txt對象的123版本之後的所有Object的版本資訊。
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123