Object Storage Service:Dapatkan informasi bucket (C++ SDK)

Catatan penggunaan

• Pada topik ini, digunakan titik akhir publik wilayah China (Hangzhou). Jika Anda mengakses OSS dari layanan Alibaba Cloud lainnya yang berada di wilayah yang sama dengan OSS, gunakan titik akhir internal. Untuk informasi selengkapnya mengenai wilayah dan titik akhir OSS, lihat Regions and endpoints.

• Pada topik ini, instans OSSClient dibuat menggunakan titik akhir OSS. Jika Anda ingin membuat OssClient menggunakan nama domain kustom atau Security Token Service (STS), lihat Create an OssClient instance.

• Untuk memperoleh informasi mengenai sebuah bucket, Anda harus memiliki izin oss:GetBucketInfo. Untuk informasi selengkapnya, lihat Attach a custom policy to a RAM user.

Kode contoh

Kode berikut menunjukkan cara memperoleh informasi mengenai sebuah bucket, seperti wilayah dan tanggal pembuatannya.

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* Inisialisasi informasi akun OSS. */
            
    /* 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. */
    std::string Endpoint = "yourEndpoint";
    
    /* Tetapkan yourRegion ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), tetapkan wilayah ke cn-hangzhou. */
    std::string Region = "yourRegion";
    
    /* Tentukan nama bucket. Misalnya, examplebucket. */
    std::string BucketName = "examplebucket";

    /* Inisialisasi sumber daya jaringan. */
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* Peroleh kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi. */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* Dapatkan informasi bucket. */
    GetBucketInfoRequest request(BucketName);
    auto outcome = client.GetBucketInfo(request);

    /* Periksa tipe redundansi data bucket. */
    if (outcome.isSuccess()) {
        std::cout << "GetBucketInfo success, DataRedundancyType:" << static_cast<int>(outcome.result().DataRedundancyType()) << std::endl;
    }
    else {
        /* Tangani pengecualian. */
        std::cout << "GetBucketInfo fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* Lepaskan sumber daya jaringan. */
    ShutdownSdk();
    return 0;
}

Referensi

Untuk informasi selengkapnya mengenai operasi API GetBucketInfo, lihat GetBucketInfo.