Object Storage Service:単一接続の帯域幅制限 (C++ SDK)

注意事項

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用してください。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

• このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient を作成する場合は、「OssClient インスタンスの作成」をご参照ください。

シンプルアップロードとダウンロードにおける単一接続の帯域幅制限の設定

次のサンプルコードは、シンプルアップロードとダウンロードで単一接続の帯域幅制限を設定する方法の例です。

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

int main(void)
{
    /* OSS アカウント情報を初期化します。*/
    
    /* yourEndpoint を、バケットが配置されているリージョンのエンドポイントに設定します。例えば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion を、バケットが配置されているリージョンに設定します。例えば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。*/
    std::string Region = "yourRegion";
    /* バケット名を指定します。例：examplebucket */
    std::string BucketName = "examplebucket";
    /* オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。例：exampledir/exampleobject.txt */
    std::string ObjectName = "exampledir/exampleobject.txt";

    /* ネットワークリソースを初期化します。*/
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* ファイルをアップロードします。*/
    std::shared_ptr<std::iostream> content = std::make_shared<std::fstream>("yourLocalFilename", std::ios::in|std::ios::binary);
    PutObjectRequest putrequest(BucketName, ObjectName,content);
    /* アップロード帯域幅の上限を 100 KB/s に設定します。*/
    putrequest.setTrafficLimit(819200);
    auto putoutcome = client.PutObject(putrequest);

    /* ファイルをローカルメモリにダウンロードします。*/
    GetObjectRequest getrequest(BucketName, ObjectName);
    /* ダウンロード帯域幅の上限を 100 KB/s に設定します。*/
    getrequest.setTrafficLimit(819200);
    auto getoutcome = client.GetObject(getrequest);

    /* ネットワークリソースを解放します。*/
    ShutdownSdk();
    return 0;
}

署名付き URL を使用したアップロードとダウンロードにおける帯域幅制限の設定

次のサンプルコードは、署名付き URL を使用してオブジェクトをアップロードまたはダウンロードする際に、単一接続の帯域幅制限を設定する方法の例です。

#include <alibabacloud/oss/OssClient.h>
#include <fstream>
using namespace AlibabaCloud::OSS;
int main(void)
{
    /* OSS アカウント情報を初期化します。*/
    
    /* yourEndpoint を、バケットが配置されているリージョンのエンドポイントに設定します。例えば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion を、バケットが配置されているリージョンに設定します。例えば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。*/
    std::string Region = "yourRegion";
    /* バケット名を指定します。例：examplebucket */
    std::string BucketName = "examplebucket";
    /* オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。例：exampledir/exampleobject.txt */
    std::string ObjectName = "exampledir/exampleobject.txt"; 

    /* ネットワークリソースを初期化します。*/
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* 署名の有効期間を設定します。最大有効期間は 32,400 秒です。*/
    std::time_t expires = std::time(nullptr) + 1200; 
    /* ファイルをアップロードするための URL を生成します。*/
    GeneratePresignedUrlRequest putrequest(BucketName, ObjectName, Http::Put);
    putrequest.setExpires(expires);
    /* アップロード帯域幅の上限を 100 KB/s に設定します。*/
    putrequest.setTrafficLimit(819200);
    auto genOutcome = client.GeneratePresignedUrl(putrequest);
    std::shared_ptr<std::iostream> content = std::make_shared<std::stringstream>();
    *content << "test cpp sdk";
    /* アップロード用の署名付き URL の結果を出力します。*/
    std::cout << "Signed URL for upload: " << genOutcome.result() << std::endl;

    /* 署名付き URL を使用してファイルをアップロードします。*/
    auto outcome = client.PutObjectByUrl(genOutcome.result(), content);
    /* ファイルをダウンロードするための URL を生成します。*/
    GeneratePresignedUrlRequest getrequest(BucketName, ObjectName, Http::Get);
    getrequest.setExpires(expires);
    /* ダウンロード帯域幅の上限を 100 KB/s に設定します。*/
    getrequest.setTrafficLimit(819200);
    genOutcome = client.GeneratePresignedUrl(getrequest);
    /* ダウンロード用の署名付き URL の結果を出力します。*/
    std::cout << "Signed URL for download: " << genOutcome.result() << std::endl;
    /* 署名付き URL を使用してファイルをダウンロードします。*/
    auto goutcome = client.GetObjectByUrl(genOutcome.result());
    
    /* ネットワークリソースを解放します。*/
    ShutdownSdk();
    return 0;
}