Bucket adalah wadah untuk objek yang disimpan di Object Storage Service (OSS). Anda harus membuat bucket sebelum mengunggah objek ke OSS. Topik ini menjelaskan cara membuat bucket menggunakan perintah mb.
Catatan penggunaan
Untuk membuat bucket, Anda memerlukan izin oss:PutBucket. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.
Mulai versi ossutil 1.6.16, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk versi ossutil sebelum 1.6.16, Anda harus menyesuaikan nama biner sesuai dengan sistem operasi. Untuk detail lebih lanjut, lihat Referensi Perintah ossutil.
Mulai pukul 10:00 (UTC+8) pada 13 Oktober 2025, OSS akan menerapkan penyesuaian bertahap di semua wilayah untuk mengaktifkan Block Public Access secara default pada bucket baru yang dibuat melalui API, OSS SDK, atau ossutil. Untuk jadwal penyesuaian di setiap wilayah, lihat [Pengumuman Resmi] Penyesuaian Konfigurasi Pemblokiran Akses Publik untuk Bucket Baru yang Dibuat. Setelah fitur Block Public Access diaktifkan, Anda tidak dapat mengonfigurasi izin akses publik, termasuk ACL publik (publik baca dan publik baca/tulis) serta kebijakan bucket yang mengizinkan akses publik. Fitur ini dapat dinonaktifkan setelah bucket dibuat jika bisnis Anda memerlukan akses publik.
Buat bucket dengan menentukan opsi dalam perintah
Sintaks Perintah
ossutil mb oss://namabucket
[--acl <nilai>]
[--storage-class <nilai>]
[--redundancy-type <nilai>]
Tabel berikut menjelaskan parameter dan opsi dalam sintaks perintah.
Parameter/Opsi | Deskripsi |
namabucket | Nama bucket yang ingin Anda buat. Nama bucket harus unik secara global di dalam OSS. Nama bucket tidak dapat diubah setelah bucket dibuat. |
--acl | Daftar kontrol akses (ACL) bucket. Nilai valid: private (default): Hanya pemilik bucket yang dapat melakukan operasi baca dan tulis pada objek di bucket. Pengguna lain tidak dapat mengakses objek di bucket. public-read: Hanya pemilik bucket yang dapat melakukan operasi tulis pada objek di bucket. Semua pengguna, termasuk pengguna anonim, dapat melakukan operasi baca pada objek di bucket. Ini dapat menyebabkan akses tidak sah ke data di bucket Anda dan biaya tinggi. Harap berhati-hati saat menetapkan ACL bucket ke public-read. public-read-write: Semua pengguna, termasuk pengguna anonim, dapat melakukan operasi baca dan tulis pada objek di bucket. Ini dapat menyebabkan akses tak terduga ke data di bucket Anda, dan Anda mungkin dikenakan biaya tak terduga. Jika pengguna mengunggah data atau informasi yang dilarang, hak hukum Anda mungkin dilanggar. Kami sarankan Anda tidak menyetel parameter ini ke public-read-write kecuali diperlukan.
|
--storage-class | Kelas penyimpanan bucket. Nilai valid: Standard (default): Kelas penyimpanan ini cocok untuk data yang sering diakses. IA: Kelas penyimpanan Infrequent Access (IA) cocok untuk data yang jarang diakses, seperti data yang diakses sekali atau dua kali sebulan. Objek IA memiliki periode penyimpanan minimum 30 hari dan ukuran tagihan minimum 64 KB. Anda dapat mengakses objek IA secara real-time. Anda dikenakan biaya pengambilan data saat mengakses objek IA. Archive: Kelas penyimpanan ini cocok untuk data yang perlu disimpan untuk jangka waktu panjang. Objek Archive memiliki periode penyimpanan minimum 60 hari dan ukuran tagihan minimum 64 KB. Anda harus memulihkan objek Archive sebelum dapat mengakses objek tersebut. Sekitar 1 menit diperlukan untuk memulihkan objek Archive. Anda dikenakan biaya pengambilan data untuk memulihkan objek Archive. ColdArchive: Kelas penyimpanan ini cocok untuk penyimpanan jangka panjang data yang hampir tidak pernah diakses. Objek Cold Archive memiliki periode penyimpanan minimum 180 hari dan ukuran tagihan minimum 64 KB. Anda harus memulihkan objek Cold Archive sebelum dapat mengakses objek tersebut. Waktu yang diperlukan untuk memulihkan objek Cold Archive bervariasi berdasarkan ukuran objek dan mode pemulihan. Anda dikenakan biaya pengambilan data untuk memulihkan objek Cold Archive.
Catatan Jika Anda menggunakan OSS pada CloudBox, hanya kelas penyimpanan Standard yang didukung. Untuk informasi lebih lanjut tentang kelas penyimpanan, lihat Kelas penyimpanan. |
--redundancy-type | Menentukan tipe redundansi bucket. Nilai valid: LRS (default): Jika Anda menetapkan tipe redundansi bucket ke penyimpanan redundan lokal (LRS), OSS menyimpan salinan setiap objek di perangkat berbeda dalam zona yang sama. Dengan cara ini, OSS memastikan keandalan dan ketersediaan data bahkan jika dua perangkat penyimpanan rusak pada saat bersamaan. ZRS: Jika Anda menetapkan tipe redundansi bucket ke penyimpanan redundan zona (ZRS), OSS menyimpan beberapa salinan data Anda di beberapa zona dalam wilayah yang sama. Data Anda tetap dapat diakses meskipun satu zona menjadi tidak tersedia.
Penting ZRS didukung di wilayah berikut: Tiongkok (Shenzhen), Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Hong Kong), Singapura, dan Indonesia (Jakarta). ZRS meningkatkan biaya penyimpanan Anda dan tidak dapat dinonaktifkan setelah diaktifkan. Berhati-hatilah saat memilih tipe redundansi ini. Jika Anda menggunakan OSS pada CloudBox, parameter ini tidak didukung.
|
Contoh
Anda dapat menjalankan perintah berikut untuk membuat bucket bernama examplebucket:
ossutil mb oss://examplebucket
Jika Anda tidak menentukan wilayah tempat bucket ingin dibuat, bucket akan dibuat di wilayah yang sesuai dengan titik akhir dalam file konfigurasi ossutil. Misalnya, jika titik akhir dalam file konfigurasi adalah https://oss-cn-hangzhou.aliyuncs.com, bucket akan dibuat di wilayah Tiongkok (Hangzhou).
Anda dapat menjalankan perintah berikut untuk membuat bucket bernama examplebucket dengan ACL bucket diatur ke private, kelas penyimpanan ke IA, dan tipe redundansi ke ZRS:
ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS
Jika keluaran sampel berikut ditampilkan, bucket examplebucket telah berhasil dibuat:
0,335189(d) elapsed
Buat bucket berdasarkan file XML yang ditentukan dalam perintah
Sintaks Perintah
ossutil mb oss://namabucket file_xml_lokal
Tabel berikut menjelaskan parameter dalam sintaks perintah.
Parameter | Deskripsi |
namabucket | Nama bucket yang ingin Anda buat. |
file_xml_lokal | Jalur file lokal yang berisi konfigurasi bucket. Contoh: localfile.xml. |
Contoh
Tentukan konfigurasi bucket dalam format XML di file localfile.xml.
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>IA</StorageClass>
<DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>
Baca konfigurasi bucket dari jalur file lokal dan tambahkan konfigurasi ke bucket yang ingin dibuat:
ossutil mb oss://examplebucket localfile.xml
Opsi umum
Jika Anda menggunakan ossutil untuk beralih ke bucket di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah bucket tersebut. Jika Anda menggunakan ossutil untuk beralih ke bucket milik akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey akun tersebut, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey akun tersebut.
Sebagai contoh, Anda dapat menjalankan perintah berikut untuk membuat bucket bernama examplebucket di wilayah Tiongkok (Shanghai) yang dimiliki oleh akun Alibaba Cloud lain:
ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret
Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.