全部产品
Search
文档中心

Object Storage Service:Dapatkan informasi bucket (C# SDK V1)

更新时间:Nov 29, 2025

Bucket adalah wadah yang menyimpan objek. Topik ini menjelaskan cara mengambil informasi tentang sebuah bucket.

Catatan

  • Topik ini menggunakan titik akhir publik wilayah China (Hangzhou) sebagai contoh. Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi selengkapnya mengenai wilayah dan titik akhir yang didukung OSS, lihat Wilayah dan titik akhir.

  • Topik ini menggunakan nama domain OSS untuk membuat instans OSSClient sebagai contoh. Jika Anda ingin membuat instans OSSClient menggunakan nama domain kustom atau Security Token Service (STS), lihat Inisialisasi (C# SDK V1).

  • Untuk mengambil informasi tentang sebuah bucket, Anda harus memiliki izin oss:GetBucketInfo. Untuk informasi selengkapnya, lihat Berikan kebijakan akses kustom kepada RAM user.

Kode contoh

Kode berikut mengambil informasi tentang sebuah bucket, seperti wilayahnya, tanggal pembuatan, dan izinnya.

using Aliyun.OSS;
using Aliyun.OSS.Common;
// Tetapkan yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), tetapkan titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
var endpoint = "yourEndpoint";
// Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah ditetapkan.
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// Tetapkan yourbucketname ke nama bucket.
var bucketName = "yourbucketname";
// Tetapkan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), tetapkan wilayah ke cn-hangzhou.
const string region = "cn-hangzhou";

// Buat instans ClientConfiguration dan ubah parameter default sesuai kebutuhan.
var conf = new ClientConfiguration();

// Gunakan Signature V4.
conf.SignatureVersion = SignatureVersion.V4;

// Buat instans OssClient.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // Informasi bucket mencakup wilayah (Region atau Location), tanggal pembuatan (CreationDate), pemilik (Owner), dan izin (Grants).
    var bucketInfo = client.GetBucketInfo(bucketName);
    Console.WriteLine("Get bucket:{0} Info succeeded ", bucketName);
    // Dapatkan wilayah tempat bucket berada.
    Console.WriteLine("bucketInfo Location: {0}", bucketInfo.Bucket.Location);
    // Dapatkan tanggal pembuatan bucket.
    Console.WriteLine("bucketInfo CreationDate: {0}", bucketInfo.Bucket.CreationDate);
    // Dapatkan tipe pemulihan bencana data bucket.
    Console.WriteLine("bucketInfo DataRedundancyType: {0}", bucketInfo.Bucket.DataRedundancyType);
    // Dapatkan izin bucket.
    Console.WriteLine("bucketInfo Grant: {0}", bucketInfo.Bucket.AccessControlList.Grant);
}
catch (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}

Referensi

Untuk informasi selengkapnya mengenai operasi API yang dapat Anda panggil untuk mengambil informasi bucket, lihat GetBucketInfo.