全部产品
Search
文档中心

Object Storage Service:list-object-versions

更新时间:Jul 02, 2025

Menampilkan versi dari semua objek dalam sebuah bucket, termasuk penanda penghapusan.

Catatan penggunaan

Untuk menampilkan versi objek, Anda harus memiliki izin oss:ListObjectVersions. Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke pengguna RAM.

Sintaks perintah

ossutil api list-object-versions --bucket value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--delimiter

string

Karakter yang ingin Anda gunakan untuk mengelompokkan objek berdasarkan nama.

--encoding-type

string

Tipe penyandian konten dalam respons.

--key-marker

string

Mengembalikan objek yang namanya secara alfabetis setelah nilai parameter key-marker. Parameter ini dapat ditentukan bersama dengan version-id-marker.

--max-keys

int

Jumlah maksimum objek yang akan dikembalikan.

--prefix

string

Awalan yang harus dimiliki oleh nama objek yang dikembalikan.

--version-id-marker

string

ID versi objek yang ditentukan oleh key-marker setelah operasi pencatatan dimulai. Versi dikembalikan dari versi terbaru hingga versi paling awal.

Catatan

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.

Contoh

  • Menampilkan versi dari semua objek dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket
  • Menampilkan versi dari semua objek dalam bucket bernama examplebucket dan memformat keluaran dalam JSON.

    ossutil api list-object-versions --bucket examplebucket --output-format json
  • Menampilkan versi dari semua objek dalam bucket bernama examplebucket dan memformat keluaran dalam YAML.

    ossutil api list-object-versions --bucket examplebucket --output-format yaml
  • Menampilkan versi dari semua objek dengan awalan nama "dir" dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket --prefix dir
  • Menampilkan versi dari 100 objek pertama dengan awalan nama "dir" dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100
  • Menampilkan versi dari semua objek di direktori saat ini dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket --delimiter /
  • Menampilkan versi dari semua objek yang namanya secara alfabetis setelah "test.txt" dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt
  • Menampilkan versi dari semua objek dalam bucket bernama examplebucket dan menyandikan URL nama objek yang dikembalikan.

    ossutil api list-object-versions --bucket examplebucket --encoding-type url
  • Menampilkan versi dari semua objek yang setelah versi "123" dari objek test.txt dalam bucket bernama examplebucket.

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123