Object Storage Service:Buat bucket (C# SDK V2)

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. Administrator Akun Alibaba Cloud harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

Peringatan

• Kode contoh dalam topik ini menggunakan wilayah China (Hangzhou) (cn-hangzhou) sebagai contoh. Secara default, kode contoh menggunakan titik akhir publik. Jika Anda ingin mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung oleh OSS, lihat Wilayah dan titik akhir.

• Mulai 13 Oktober 2025 pukul 10:00 (UTC+8), OSS akan menerapkan penyesuaian bertahap di semua wilayah untuk mengaktifkan Blokir Akses Publik secara default untuk bucket baru yang dibuat menggunakan API, OSS SDK, atau ossutil. Untuk detail waktu pasti ketika penyesuaian akan berlaku di setiap wilayah, lihat [Pengumuman Resmi] Penyesuaian Konfigurasi Blokir Akses Publik untuk Bucket Baru. Setelah Blokir Akses Publik diaktifkan, Anda tidak dapat mengonfigurasi izin akses publik, termasuk ACL publik (baca publik dan baca/tulis publik) dan kebijakan bucket yang mengizinkan akses publik. Anda dapat menonaktifkan fitur ini setelah bucket dibuat jika bisnis Anda memerlukan akses publik.

Kode contoh

Gunakan kode berikut untuk membuat bucket:

using OSS = AlibabaCloud.OSS.V2; // Buat alias untuk Alibaba Cloud OSS SDK untuk menyederhanakan penggunaan selanjutnya.

var region = "cn-hangzhou"; // Diperlukan. Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
var bucket = "nama bucket Anda";  // Diperlukan. Tentukan nama bucket yang akan dibuat.
var endpoint = null as string;  // Opsional. Tentukan nama domain yang digunakan untuk mengakses OSS. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir menjadi https://oss-cn-hangzhou.aliyuncs.com.

// Muat konfigurasi default OSS SDK. Konfigurasi ini secara otomatis membaca informasi kredensial (seperti AccessKey) dari variabel lingkungan.
var cfg = OSS.Configuration.LoadDefault();
// Secara eksplisit atur penggunaan variabel lingkungan untuk mendapatkan kredensial untuk verifikasi identitas (format: OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET).
cfg.CredentialsProvider = new OSS.Credentials.EnvironmentVariableCredentialsProvider();
// Atur wilayah bucket dalam konfigurasi.
cfg.Region = region;
// Jika titik akhir ditentukan, timpa titik akhir default.
if(endpoint != null)
{
    cfg.Endpoint = endpoint;
}

// Buat instans klien OSS berdasarkan informasi konfigurasi.
using var client = new OSS.Client(cfg);

// Panggil metode PutBucketAsync untuk membuat bucket baru. Kelas penyimpanannya adalah Standard.
var result = await client.PutBucketAsync(new OSS.Models.PutBucketRequest()
{
    Bucket = bucket
});

// Cetak hasil pembuatan.
Console.WriteLine("PutBucket selesai");  // Operasi selesai.
Console.WriteLine($"Kode Status: {result.StatusCode}");  // Kode status HTTP
Console.WriteLine($"RequestId: {result.RequestId}");  // RequestId, yang digunakan oleh Alibaba Cloud untuk pemecahan masalah.
Console.WriteLine("Header Respons:");  // Informasi header respons
result.Headers.ToList().ForEach(x => Console.WriteLine(x.Key + " : " + x.Value));  // Telusuri dan cetak semua header respons.

Referensi

Untuk kode contoh lengkap untuk membuat bucket, lihat PutBucket.cs.