Cara membuat bucket - Object Storage Service

Bucket adalah wadah untuk menyimpan objek. Semua objek harus disimpan dalam sebuah bucket. Topik ini menjelaskan cara membuat bucket.

Catatan

Sebelum menjalankan kode contoh dalam topik ini, Anda harus membuat instans OSSClient menggunakan metode seperti nama domain kustom atau Security Token Service (STS). Untuk informasi selengkapnya, lihat Inisialisasi instans OSSClient untuk Android.
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 detail waktu pasti penerapan penyesuaian tersebut di tiap wilayah, lihat [Pengumuman Resmi] Penyesuaian Konfigurasi Pemblokiran Akses Publik untuk Bucket Baru. Setelah Block Public Access diaktifkan, Anda tidak dapat mengonfigurasi izin akses publik, termasuk ACL publik (public read dan public read/write) serta kebijakan bucket yang mengizinkan akses publik. Anda dapat menonaktifkan fitur ini setelah bucket dibuat jika bisnis Anda memerlukan akses publik.

Izin

Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan bucket.

API	Action	Definisi
PutBucket	`oss:PutBucket`	Membuat bucket.
PutBucket	`oss:PutBucketAcl`	Setelah bucket dibuat, izin ini diperlukan untuk mengubah ACL bucket.

Kode contoh

Kode berikut menunjukkan cara membuat bucket bernama examplebucket.

Catatan

Wilayah bucket ditentukan oleh wilayah titik akhir yang Anda tentukan saat inisialisasi.

// Buat permintaan untuk membuat bucket.
// Tentukan nama bucket.
CreateBucketRequest createBucketRequest = new CreateBucketRequest("examplebucket");
// Tentukan daftar kontrol akses (ACL) bucket.
// createBucketRequest.setBucketACL(CannedAccessControlList.Private);
// Tentukan kelas penyimpanan bucket.
// createBucketRequest.setBucketStorageClass(StorageClass.Standard);

// Buat bucket secara asinkron.
OSSAsyncTask createTask = oss.asyncCreateBucket(createBucketRequest, new OSSCompletedCallback<CreateBucketRequest, CreateBucketResult>() {
    @Override
    public void onSuccess(CreateBucketRequest request, CreateBucketResult result) {
        Log.d("asyncCreateBucket", "Success");
    }
    @Override
    public void onFailure(CreateBucketRequest request, ClientException clientException, ServiceException serviceException) {
        // Exception permintaan.
        if (clientException != null) {
            // Exception sisi client, seperti error jaringan.
            clientException.printStackTrace();
        }
        if (serviceException != null) {
            // Exception sisi server.
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});

Referensi

Untuk kode contoh lengkap pembuatan bucket, lihat contoh GitHub.
Untuk informasi selengkapnya tentang Operasi API pembuatan bucket, lihat PutBucket.
Untuk informasi selengkapnya tentang cara menginisialisasi instans OSSClient, lihat Inisialisasi instans OSSClient untuk Android.