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

Catatan

• Kode contoh dalam topik ini menggunakan ID Wilayah China (Hangzhou) cn-hangzhou sebagai contoh. Secara default, Titik akhir publik digunakan. Jika Anda ingin mengakses OSS dari layanan Alibaba Cloud lainnya dalam 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.

• Untuk mencantumkan bucket, Anda harus memiliki izin oss:ListBuckets. Untuk informasi lebih lanjut, lihat Memberikan izin khusus kepada Pengguna RAM.

• Saat menggunakan SDK untuk mencantumkan bucket, Anda dapat menentukan ID kelompok sumber daya untuk hanya mencantumkan bucket yang termasuk dalam kelompok sumber daya tersebut.

  • Secara default, jika Anda tidak menentukan ID kelompok sumber daya, permintaan tidak menyertakan parameter ini, dan tanggapan XML tidak berisi informasi tentang kelompok sumber daya.

  • Jika parameter ID kelompok sumber daya disertakan dalam permintaan, OSS mengembalikan semua bucket yang termasuk dalam kelompok sumber daya yang ditentukan.

  • Jika parameter ID kelompok sumber daya tidak disertakan dalam permintaan, OSS mengembalikan semua bucket yang dimiliki oleh peminta.

Daftarkan semua bucket di semua Wilayah untuk akun saat ini

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. Dalam contoh ini, Wilayah China (Hangzhou) digunakan. Atur Wilayah ke cn-hangzhou.
var endpoint = null as string;  // Opsional. Tentukan Nama domain yang digunakan untuk mengakses layanan OSS. Misalnya, jika bucket berada di Wilayah China (Hangzhou), atur Titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.

// Muat konfigurasi default dari OSS SDK. Konfigurasi 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, itu akan menimpa Titik akhir default.
if(endpoint != null)
{
    cfg.Endpoint = endpoint;
}

// Buat instance Klien OSS menggunakan informasi konfigurasi.
using var client = new OSS.Client(cfg);

// Buat paginator untuk operasi ListBuckets untuk memproses hasil halaman.
// ListBucketsRequest adalah model permintaan yang didefinisikan oleh SDK. Dalam contoh ini, konstruktor default digunakan untuk mendapatkan semua bucket. 
var paginator = client.ListBucketsPaginator(new OSS.Models.ListBucketsRequest());

Console.WriteLine("Bucket:");
await foreach (var page in paginator.IterPageAsync())
{
// Telusuri setiap bucket di halaman saat ini.
    foreach (var bucket in page.Buckets ?? [])
    {
    // Cetak informasi bucket: nama, kelas penyimpanan, dan lokasi.
    Console.WriteLine($"Bucket:{bucket.Name}, {bucket.StorageClass}, {bucket.Location}");
    }
}

Referensi

Untuk kode contoh lengkap untuk mencantumkan bucket, lihat list_buckets.cs.