全部產品
Search
文件中心

Object Storage Service:list-object-versions

更新時間:Aug 01, 2024

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