Halaman keseluruhan daftar besar kontainer atau objek (containers atau objects)¶
Jika Anda memiliki sejumlah besar kontainer atau objek, Anda dapat menggunakan parameter marker, limit, dan end_marker untuk mengontrol berapa banyak barang yang dikembalikan dalam daftar dan dimana daftar dimulai atau berakhir.
- marker
- Ketika Anda meminta daftar kontainer atau objek, Object Storage mengembalikan maksimum 10.000 nama untuk setiap permintaan. Untuk mendapatkan nama berikutnya, Anda harus membuat permintaan lain dengan parameter
marker. Mengatur parametermarkerdengan nama item terakhir kembali dalam daftar sebelumnya. Anda harus URL-encode nilaimarkersebelum Anda mengirim permintaan HTTP. Object Storage mengembalikan maksimum 10.000 nama akan memulai setelah item terakhir kembali.
- limit
- Untuk kembali kurang dari 10.000 nama, gunakan parameter
limit. Jika jumlah nama kembali sama ditentukanlimit(atau 10.000 jika Anda menghilangkan parameterlimit), Anda dapat mengasumsikan ada lebih nama untuk daftar. Jika jumlah nama dalam daftar adalah tepat habis dibagi oleh nilailimit, permintaan terakhir tidak memiliki konten.
- end_marker
- Membatasi hasil ditetapkan untuk nama yang kurang dari nilai parameter
end_marker. Anda harus URL-encode nilaiend_markersebelum Anda mengirim permintaan HTTP.
Untuk halaman keseluruhan daftar besar kontainer¶
Asumsikan berikut daftar nama kontainer:
apples
bananas
kiwis
oranges
pears
Gunakan `` limit`` dua:
# curl -i $publicURL/?limit=2 -X GET -H "X-Auth-Token: $token"
apples bananas
Karena dua nama kontainer dikembalikan, ada lebih nama untuk daftar.
Membuat permintaan lain dengan parameter
markerset nama dari item terakhir kembali:# curl -i $publicURL/?limit=2&marker=bananas -X GET -H \ “X-Auth-Token: $token"
kiwis oranges
Sekali lagi, dua barang yang dikembalikan, dan mungkin ada lebih.
Membuat permintaan lain dengan
markerdari item terakhir kembali:# curl -i $publicURL/?limit=2&marker=oranges -X GET -H \” X-Auth-Token: $token"
pearsAnda menerima respon one-item, yang lebih sedikit daripada jumlah
limitnama. Hal ini menunjukkan bahwa ini adalah akhir dari daftar.Gunakan parameter
end_markeruntuk membatasi hasil set ke objek nama yang kurang dari nilai parameterend_marker:# curl -i $publicURL/?end_marker=oranges -X GET -H \” X-Auth-Token: $token"
apples bananas kiwis
Anda menerima hasil set semua nama kontainer sebelum nilai end-marker`.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.