Object Storage Service:OSS C++ SDK V2

Prasyarat

• Kompilator C++17 atau versi lebih baru (GCC 7+, Clang 5+, atau MSVC 2017+).

• CMake 3.15 atau versi lebih baru.

Jalankan perintah cmake --version untuk memeriksa versi CMake Anda. Jika CMake belum terinstal atau versinya lebih lama dari 3.15, unduh dan instal CMake.

Instal SDK

Kami menyarankan menggunakan vcpkg untuk menginstal OSS C++ SDK V2.

vcpkg install alibabacloud-oss-cpp-sdk-v2[curl]

# Di Windows, Anda dapat menggunakan WinHTTP sebagai lapisan transport HTTP.
vcpkg install alibabacloud-oss-cpp-sdk-v2[winhttp]

git clone https://github.com/aliyun/alibabacloud-oss-cpp-sdk-v2.git
vcpkg install alibabacloud-oss-cpp-sdk-v2[curl] --overlay-ports=alibabacloud-oss-cpp-sdk-v2/vcpkg --head

git clone https://github.com/aliyun/alibabacloud-oss-cpp-sdk-v2.git
cd alibabacloud-oss-cpp-sdk-v2
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local
cmake --build . --target install

Tambahkan dependensi ke file CMakeLists.txt proyek Anda:

cmake_minimum_required(VERSION 3.15)
project(my-app)

find_package(alibabacloud_oss_v2 REQUIRED)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE alibabacloud_oss_v2::oss)

Konfigurasikan kredensial akses

Konfigurasikan kredensial akses dengan menyetel variabel lingkungan menggunakan AccessKey Pengguna RAM Anda.

Di Konsol RAM, buat Pengguna RAM dan hasilkan AccessKey permanen. Simpan AccessKey tersebut, lalu berikan izin AliyunOSSFullAccess kepada pengguna.

Inisialisasi klien

SDK menyediakan tiga mode permintaan: OSSClient (sinkron), OSSClient (asinkron) (permintaan asinkron berbasis kolam thread), dan OSSAsyncClient (asinkron) (permintaan asinkron native). Pilih mode berdasarkan kasus penggunaan Anda. Contoh berikut menunjukkan setiap mode dengan menggunakan operasi ListBuckets untuk mencantumkan bucket dalam akun Anda.

#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();

    oss::OSSClient client(conf);

    auto outcome = client.listBuckets(
        oss::models::ListBucketsRequest());

    if (!outcome.has_value()) {
        auto& err = outcome.error();
        std::cerr << "Error Code: " << err.getCode() << std::endl;
        std::cerr << "Error Message: " << err.getMessage() << std::endl;
        std::cerr << "Request ID: " << err.getRequestId() << std::endl;
        return 1;
    }

    auto& result = outcome.value();
    for (auto& bucket : result.getBuckets()) {
        std::cout << "bucket: name:" << bucket.name
                  << ", region:" << bucket.region
                  << ", storageClass:" << bucket.storageClass
                  << std::endl;
    }

    return 0;
}

#include <future>
#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"
#include "alibabacloud/oss2/utils/DefaultExecutor.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
    // Penting: Konfigurasikan kolam thread untuk mengaktifkan dukungan asyncCall() pada OSSClient.
    conf.executor = std::make_shared<oss::DefaultExecutor>();

    oss::OSSClient client(conf);

    // Pemanggilan asinkron yang mengembalikan std::future.
    auto future = client.asyncCall(oss::models::ListBucketsRequest());

    // Tunggu hasilnya menggunakan get() (pola future).
    auto outcome = future.get();
    if (!outcome.has_value()) {
        auto& err = outcome.error();
        std::cerr << "Error Code: " << err.getCode() << std::endl;
        std::cerr << "Error Message: " << err.getMessage() << std::endl;
        return 1;
    }

    auto& result = outcome.value();
    for (auto& bucket : result.getBuckets()) {
        std::cout << "bucket: name:" << bucket.name
                  << ", region:" << bucket.region << std::endl;
    }
    return 0;
}

#include <iostream>
#include <thread>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSAsyncClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();

    auto client = std::make_shared<oss::OSSAsyncClient>(conf);

    client->listBucketsAsync(
        oss::models::ListBucketsRequest(),
        oss::ListBucketsAsyncCallback([](oss::ListBucketsOutcome outcome) {
            if (!outcome.has_value()) {
                auto& err = outcome.error();
                std::cerr << "Error Code: " << err.getCode() << std::endl;
                std::cerr << "Error Message: " << err.getMessage() << std::endl;
                return;
            }

            auto& result = outcome.value();
            for (auto& bucket : result.getBuckets()) {
                std::cout << "bucket: name:" << bucket.name
                          << ", region:" << bucket.region
                          << ", storageClass:" << bucket.storageClass
                          << std::endl;
            }
        }));

    // Tunggu hingga operasi asinkron selesai.
    std::this_thread::sleep_for(std::chrono::seconds(5));

    return 0;
}

Gunakan domain kustom

Titik akhir OSS default mungkin mencegah akses langsung browser untuk pratinjau file. Dengan menggunakan domain kustom untuk mengakses OSS, Anda dapat mengaktifkan pratinjau dan menggunakan CDN untuk pengiriman yang dipercepat.

Sebelum menjalankan kode contoh, ganti <region-id> dengan ID wilayah yang sebenarnya dari daftar wilayah dan titik akhir, seperti ap-southeast-1.

#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.endpoint = "https://your-custom-domain.com";
    conf.useCName = true;
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();

    oss::OSSClient client(conf);

    // Lakukan operasi menggunakan domain kustom.
    auto outcome = client.putObject(
        oss::models::PutObjectRequest()
            .setBucket("your-bucket")
            .setKey("your-key")
            .setBody(oss::RequestBody::fromString("Hello, OSS!")));

    if (!outcome.has_value()) {
        auto& err = outcome.error();
        std::cerr << "Error: " << err.getMessage() << std::endl;
        return 1;
    }

    std::cout << "Unggah berhasil" << std::endl;
    return 0;
}

Kontrol waktu tunggu

Gunakan connectTimeout dan readWriteTimeout untuk mengonfigurasi waktu tunggu koneksi dan baca/tulis dalam milidetik.

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
// Atur waktu tunggu koneksi menjadi 10 detik.
conf.connectTimeout = 10000;
// Atur waktu tunggu baca/tulis menjadi 30 detik.
conf.readWriteTimeout = 30000;

oss::OSSClient client(conf);

Kebijakan percobaan ulang

C++ SDK V2 memiliki StandardRetryer bawaan. Secara default, ini menggunakan strategi backoff FullJitterBackoff dengan maksimal 3 kali percobaan ulang. Anda dapat menggunakan retryMaxAttempts untuk mengatur jumlah maksimum percobaan ulang.

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
// Atur jumlah maksimum percobaan ulang menjadi 5.
conf.retryMaxAttempts = 5;

oss::OSSClient client(conf);

Untuk contoh lain tentang strategi percobaan ulang kustom, lihat CustomRetryStrategy.cpp.

Protokol HTTP/HTTPS

Protokol HTTPS digunakan secara default. Untuk menggunakan protokol HTTP, setel disableSsl ke true.

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
// Gunakan protokol HTTP.
conf.disableSsl = true;

oss::OSSClient client(conf);

Gunakan titik akhir internal

Saat aplikasi Anda dideploy di ECS, Anda dapat menggunakan titik akhir internal untuk mengakses OSS dan mengurangi biaya lalu lintas jaringan publik.

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
// Gunakan titik akhir internal.
conf.useInternalEndpoint = true;

oss::OSSClient client(conf);

Gunakan titik akhir akselerasi transfer

Akses OSS melalui titik akhir akselerasi transfer untuk meningkatkan kinerja transfer data jarak jauh.

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
// Gunakan titik akhir akselerasi transfer.
conf.useAccelerateEndpoint = true;

oss::OSSClient client(conf);

Gunakan domain kustom (CNAME)

Akses OSS dengan menggunakan domain kustom (CNAME).

auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region-id>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
conf.endpoint = "https://your-custom-domain.com";
conf.useCName = true;

oss::OSSClient client(conf);

Kustomisasi transport HTTP

C++ SDK V2 menggunakan cURL sebagai lapisan transport HTTP secara default. Anda dapat menggantinya dengan implementasi lain menggunakan parameter httpTransport. WinHTTP juga didukung di Windows.

Untuk contoh lapisan transport kustom, lihat CurlCustomConfig.cpp dan WinHttpCustomConfig.cpp.

Access key Pengguna RAM

Jika aplikasi Anda berjalan di lingkungan aman dan stabil yang tidak terpapar internet, gunakan access key Pengguna RAM.

#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::StaticCredentialsProvider>(
        "YOUR_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_SECRET");

    oss::OSSClient client(conf);
    // Gunakan klien untuk melakukan operasi.
    return 0;
}

Kredensial sementara STS

Jika aplikasi Anda memerlukan akses sementara ke OSS, Anda dapat menggunakan kredensial sementara STS, yang mencakup ID access key, secret access key, dan token keamanan. Anda harus mengelola dan menyegarkan token STS ini secara manual, yang dapat menambah kompleksitas dan risiko keamanan.

#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::StaticCredentialsProvider>(
        "STS_ACCESS_KEY_ID", "STS_ACCESS_KEY_SECRET", "STS_SECURITY_TOKEN");

    oss::OSSClient client(conf);
    // Gunakan klien untuk melakukan operasi.
    return 0;
}

RAMRoleARN, ECSRAMRole, atau OIDCRoleARN

Untuk metode kredensial seperti RAMRoleARN, ECSRAMRole, dan OIDCRoleARN, kami menyarankan menggunakan pustaka alibabacloud-credentials-cpp dengan CredentialsProviderFunc.

1. Instal dependensi.

   vcpkg install alibabacloud-credentials-cpp

2. Tambahkan dependensi dalam file CMakeLists.txt Anda.

   find_package(alibabacloud_credentials REQUIRED)

3. Integrasikan pustaka menggunakan CredentialsProviderFunc.

   RAMRoleARN

   #include "alibabacloud/oss2/ClientConfiguration.h"
   #include "alibabacloud/oss2/OSSClient.h"
   #include "alibabacloud/oss2/credentials/CredentialsProvider.h"
   #include <darabonba/core/Client.hpp>
   #include <alibabacloud/credential.hpp>
   
   namespace oss = alibabacloud::oss2;
   
   int main() {
       auto credConfig = std::make_shared<Alibabacloud_Credential::Config>();
       // Jenis kredensial harus ram_role_arn.
       credConfig->type = std::make_shared<std::string>("ram_role_arn");
       // ID access key Pengguna RAM. Untuk menghindari hardcoding, kami menyarankan menyuntikkan nilai ini melalui variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID.
       credConfig->accessKeyId = std::make_shared<std::string>("YOUR_ACCESS_KEY_ID");
       // Secret access key Pengguna RAM. Untuk menghindari hardcoding, kami menyarankan menyuntikkan nilai ini melalui variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET.
       credConfig->accessKeySecret = std::make_shared<std::string>("YOUR_ACCESS_KEY_SECRET");
       // ARN peran RAM yang akan diasumsikan. Contoh: acs:ram::123456789012****:role/adminrole
       // Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_ROLE_ARN.
       credConfig->roleArn = std::make_shared<std::string>("YOUR_ROLE_ARN");
       // Nama sesi peran, digunakan untuk tujuan audit. Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_ROLE_SESSION_NAME.
       credConfig->roleSessionName = std::make_shared<std::string>("your-session-name");
       // (Opsional) Batasi lebih lanjut izin dengan kebijakan. Parameter ini tidak wajib.
       // Contoh: {"Statement":[{"Action":["oss:GetObject"],"Effect":"Allow","Resource":["*"]}],"Version":"1"}
       // credConfig->policy = std::make_shared<std::string>("<Policy>");
       // (Opsional) Durasi sesi peran dalam detik. Default: 3600 (1 jam). Parameter ini tidak wajib.
       // credConfig->roleSessionExpiration = std::make_shared<long>(3600);
   
       auto credClient = std::make_shared<Alibabacloud_Credential::Client>(credConfig);
   
       auto conf = oss::ClientConfiguration::loadDefault();
       conf.region = "<region-id>";
       conf.credentialsProvider = std::make_shared<oss::CredentialsProviderFunc>(
           [credClient]() -> oss::Credentials {
               auto cred = credClient->getCredential();
               auto ak = cred.getAccessKeyId();
               auto sk = cred.getAccessKeySecret();
               if (ak.empty() || sk.empty()) {
                   return oss::Credentials::withRetryableError(
                       "failed to get credentials from alibabacloud-credentials-cpp");
               }
               auto token = cred.getSecurityToken();
               return oss::Credentials(std::move(ak), std::move(sk), std::move(token));
           });
   
       oss::OSSClient client(conf);
       // Gunakan klien untuk melakukan operasi.
       return 0;
   }

   ECSRAMRole

   #include "alibabacloud/oss2/ClientConfiguration.h"
   #include "alibabacloud/oss2/OSSClient.h"
   #include "alibabacloud/oss2/credentials/CredentialsProvider.h"
   #include <darabonba/core/Client.hpp>
   #include <alibabacloud/credential.hpp>
   
   namespace oss = alibabacloud::oss2;
   
   int main() {
       auto credConfig = std::make_shared<Alibabacloud_Credential::Config>();
       // Jenis kredensial harus ecs_ram_role.
       credConfig->type = std::make_shared<std::string>("ecs_ram_role");
       // Nama peran RAM yang diberikan ke instans ECS. Parameter ini opsional.
       // Jika tidak disetel, SDK secara otomatis mengambilnya dari layanan metadata.
       // Kami sangat menyarankan menyetel parameter ini secara eksplisit untuk mengurangi permintaan ke layanan metadata.
       credConfig->roleName = std::make_shared<std::string>("YOUR_ECS_ROLE_NAME");
   
       auto credClient = std::make_shared<Alibabacloud_Credential::Client>(credConfig);
   
       auto conf = oss::ClientConfiguration::loadDefault();
       conf.region = "<region-id>";
       conf.credentialsProvider = std::make_shared<oss::CredentialsProviderFunc>(
           [credClient]() -> oss::Credentials {
               auto cred = credClient->getCredential();
               auto ak = cred.getAccessKeyId();
               auto sk = cred.getAccessKeySecret();
               if (ak.empty() || sk.empty()) {
                   return oss::Credentials::withRetryableError(
                       "failed to get credentials from alibabacloud-credentials-cpp");
               }
               auto token = cred.getSecurityToken();
               return oss::Credentials(std::move(ak), std::move(sk), std::move(token));
           });
   
       oss::OSSClient client(conf);
       // Gunakan klien untuk melakukan operasi.
       return 0;
   }

   OIDCRoleARN

   #include "alibabacloud/oss2/ClientConfiguration.h"
   #include "alibabacloud/oss2/OSSClient.h"
   #include "alibabacloud/oss2/credentials/CredentialsProvider.h"
   #include <darabonba/core/Client.hpp>
   #include <alibabacloud/credential.hpp>
   
   namespace oss = alibabacloud::oss2;
   
   int main() {
       auto credConfig = std::make_shared<Alibabacloud_Credential::Config>();
       // Jenis kredensial harus oidc_role_arn.
       credConfig->type = std::make_shared<std::string>("oidc_role_arn");
       // ARN peran RAM yang akan diasumsikan. Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_ROLE_ARN.
       credConfig->roleArn = std::make_shared<std::string>("YOUR_ROLE_ARN");
       // ARN penyedia identitas OIDC. Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_OIDC_PROVIDER_ARN.
       credConfig->oidcProviderArn = std::make_shared<std::string>("YOUR_OIDC_PROVIDER_ARN");
       // Path ke file token OIDC, yang secara otomatis dimount ke dalam pod oleh RRSA. Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_OIDC_TOKEN_FILE.
       credConfig->oidcTokenFilePath = std::make_shared<std::string>("/var/run/secrets/tokens/oidc-token");
       // Nama sesi peran, digunakan untuk tujuan audit. Anda juga dapat menyetel nilai ini menggunakan variabel lingkungan ALIBABA_CLOUD_ROLE_SESSION_NAME.
       credConfig->roleSessionName = std::make_shared<std::string>("your-session-name");
       // (Opsional) Batasi lebih lanjut izin dengan kebijakan. Parameter ini tidak wajib.
       // credConfig->policy = std::make_shared<std::string>("<Policy>");
   
       auto credClient = std::make_shared<Alibabacloud_Credential::Client>(credConfig);
   
       auto conf = oss::ClientConfiguration::loadDefault();
       conf.region = "<region-id>";
       conf.credentialsProvider = std::make_shared<oss::CredentialsProviderFunc>(
           [credClient]() -> oss::Credentials {
               auto cred = credClient->getCredential();
               auto ak = cred.getAccessKeyId();
               auto sk = cred.getAccessKeySecret();
               if (ak.empty() || sk.empty()) {
                   return oss::Credentials::withRetryableError(
                       "failed to get credentials from alibabacloud-credentials-cpp");
               }
               auto token = cred.getSecurityToken();
               return oss::Credentials(std::move(ak), std::move(sk), std::move(token));
           });
   
       oss::OSSClient client(conf);
       // Gunakan klien untuk melakukan operasi.
       return 0;
   }

   Untuk contoh kredensial lainnya, lihat contoh kredensial.

Akses anonim

Jika bucket dan objek yang ingin Anda akses memiliki izin baca-publik, Anda dapat menggunakan akses anonim.

#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = std::make_shared<oss::AnonymousCredentialsProvider>();

    oss::OSSClient client(conf);
    // Gunakan klien untuk melakukan operasi.
    return 0;
}

Penyedia kredensial kustom

Jika metode kredensial di atas tidak memenuhi kebutuhan Anda, Anda dapat menyesuaikan logika pengambilan kredensial menggunakan CredentialsProviderFunc.

#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

#include <cstdlib>

namespace oss = alibabacloud::oss2;

// Contoh: Muat kredensial dari variabel lingkungan kustom atau file konfigurasi.
static oss::Credentials loadCredentialsFromCustomSource() {
    // Dalam aplikasi dunia nyata, Anda dapat mengambil kredensial dari berbagai sumber:
    //   - File konfigurasi (seperti ~/.ossrc)
    //   - Layanan manajemen kunci (seperti HashiCorp Vault atau KMS)
    //   - Layanan metadata
    //   - Database
    const char* ak = std::getenv("MY_APP_ACCESS_KEY_ID");
    const char* sk = std::getenv("MY_APP_ACCESS_KEY_SECRET");
    const char* token = std::getenv("MY_APP_SESSION_TOKEN");

    if (!ak || !sk) {
        // Pesan error ini akan diteruskan ke OperationError::getMessage().
        return oss::Credentials::withError(
            "MY_APP_ACCESS_KEY_ID dan MY_APP_ACCESS_KEY_SECRET harus disetel");
        // Untuk kegagalan sementara, seperti timeout jaringan, gunakan withRetryableError.
        // SDK secara otomatis mencoba ulang pengambilan kredensial.
        // return oss::Credentials::withRetryableError("...");
    }

    return oss::Credentials(ak, sk, token ? token : "");
}

int main() {
    // Fungsi penyedia kredensial kustom dipanggil setiap kali kredensial diperlukan,
    // memungkinkan Anda mengimplementasikan logika rotasi, penyegaran, atau caching.
    auto provider = std::make_shared<oss::CredentialsProviderFunc>(
        loadCredentialsFromCustomSource);

    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region-id>";
    conf.credentialsProvider = provider;

    oss::OSSClient client(conf);
    // Gunakan klien untuk melakukan operasi.
    return 0;
}

Konvensi penamaan API

Nama metode menggunakan gaya camelCase. Setiap operasi menerima parameter <OperationName>Request dan mengembalikan <OperationName>Outcome (Outcome<Result, Error>).

OSSClient (sinkron):

OutcomeType operationName(const models::OperationNameRequest& request, const OperationOptions* options = nullptr)

OSSAsyncClient (asinkron native):

void operationNameAsync(const models::OperationNameRequest& request, const OperationNameAsyncCallback& callback, const OperationOptions* options = nullptr)

Mode pemanggilan

Membatalkan permintaan

Untuk membatalkan operasi berdurasi panjang dengan CancellationToken, teruskan cancellationToken dalam OperationOptions. OSS C++ SDK V2 menyediakan dua mode pembatalan:

// Batalkan permintaan dari thread lain.
auto cts = oss::CancellationTokenSource::create();

oss::OperationOptions opts;
opts.cancellationToken = cts->getToken();

// Mulai permintaan di thread lain.
auto future = std::async([&]() {
    return client.getObject(request, &opts);
});

// Batalkan dari thread saat ini.
cts->cancel();

// Atur timeout 30 detik untuk pembatalan otomatis.
auto cts = oss::CancellationTokenSource::create();
cts->cancelAfter(std::chrono::seconds(30));

oss::OperationOptions opts;
opts.cancellationToken = cts->getToken();

auto outcome = client.getObject(request, &opts);

Penanganan error

OSS C++ SDK V2 menggunakan Outcome<Result, Error>, yang kompatibel dengan std::expected. Panggil has_value() untuk memeriksa keberhasilan. Jika berhasil, ambil hasilnya dengan value() atau dengan mendereferensiasi objek outcome (*outcome). Jika gagal, ambil objek error dengan error().

auto outcome = client.putObject(request);

if (!outcome.has_value()) {
    auto& err = outcome.error();
    std::cerr << "Error code: " << err.getCode() << std::endl;
    std::cerr << "Error message: " << err.getMessage() << std::endl;
    std::cerr << "EC: " << err.getEC() << std::endl;
    std::cerr << "Request ID: " << err.getRequestId() << std::endl;
    std::cerr << "Request target: " << err.getRequestTarget() << std::endl;
}

Saat Anda membangun dengan flag -DUSE_STD_EXPECTED=ON (C++23), Outcome menjadi alias tipe untuk std::expected, yang mendukung operasi monadik seperti .and_then(), .transform(), dan .or_else().