Bucket, objek, dan ACL
Bucket adalah lokasi penyimpanan tempat Anda membaca dan menulis file. Anda harus selalu menentukan bucket saat menggunakan library klien App Engine untuk Cloud Storage. Project Anda dapat mengakses beberapa bucket. Perlu diperhatikan bahwa library klien tidak mendukung pembuatan bucket.
Daftar kontrol akses (ACL) mengontrol akses ke bucket dan ke objek yang ada di dalamnya. Project dan aplikasi App Engine Anda akan otomatis ditambahkan ke ACL yang mengizinkan akses bucket saat Anda membuat bucket dalam project.
Perhatikan bahwa ACL yang mengizinkan akses bucket berbeda dengan kemungkinan banyak ACL yang mengatur objek dalam bucket tersebut. Dengan demikian, aplikasi Anda memiliki hak istimewa baca dan tulis ke bucket tempatnya diaktifkan, tetapi hanya memiliki hak penuh atas objek yang dibuatnya di bucket. Akses aplikasi Anda ke objek yang dibuat oleh aplikasi atau orang lain terbatas pada hak yang diberikan kepada aplikasi Anda oleh pembuat objek.
Jika objek dibuat di bucket tanpa ACL yang ditentukan secara eksplisit untuknya,
objek tersebut akan menggunakan ACL objek default yang ditetapkan ke bucket oleh pemilik bucket. Jika
pemilik bucket belum menentukan ACL objek default, default objek adalah
public-read
, yang berarti bahwa siapa pun yang diizinkan akses bucket dapat membaca objek tersebut.
ACL dan library klien
Aplikasi yang menggunakan library klien tidak dapat mengubah ACL bucket, tetapi dapat menentukan ACL yang mengontrol akses ke objek yang dibuatnya. Setelan ACL yang tersedia dijelaskan di bagian dokumentasi untuk metode terbuka.Mengubah objek Cloud Storage
Setelah membuat objek dalam bucket, Anda tidak dapat memodifikasi atau menambahkannya. Sebagai gantinya, Anda harus menimpa objek tersebut dengan objek baru bernama sama yang berisi perubahan yang diinginkan.
Cloud Storage dan subdirektori
Dengan library klien App Engine untuk Cloud Storage, Anda dapat menyediakan pemisah subdirektori saat membuat objek, tetapi tidak ada subdirektori yang sebenarnya di Cloud Storage. Sebagai gantinya, subdirektori di Cloud Storage adalah bagian dari nama file objek.
Misalnya, Anda mungkin berasumsi bahwa membuat objek
somewhere/over/the/rainbow.mp3
akan menyimpan file rainbow.mp3
di
subdirektori somewhere/over/the/
. Sebagai gantinya, nama objek ditetapkan ke
somewhere/over/the/rainbow.mp3
.
Konsep ini penting untuk dipahami saat menggunakan pemfilteran listbucket
.
Jika perilaku listingan di atas tidak optimal untuk Anda, listbucket
memiliki mode emulasi direktori opsional. Lihat
listbucket
untuk informasi lebih lanjut.
Langkah selanjutnya
- Baca dokumentasi Referensi API.
- Pelajari cara menyiapkan Cloud Storage.