アーカイブオブジェクトとコールドアーカイブオブジェクトを解凍する方法 - Object Storage Service

アーカイブオブジェクトまたはコールドアーカイブオブジェクトを読み取るには、事前に解凍する必要があります。このトピックでは、アーカイブオブジェクトとコールドアーカイブオブジェクトを解凍する方法について説明します。

注意事項

RestoreObject メソッドは、アーカイブオブジェクトとコールドアーカイブオブジェクトでのみサポートされています。
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。 OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient を作成する場合は、「OssClient インスタンスの作成」をご参照ください。
オブジェクトを解凍するには、oss:RestoreObject 権限が必要です。詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。

アーカイブオブジェクトの解凍

次のコードは、アーカイブオブジェクトを解凍する方法の例です。

#include <alibabacloud/oss/OssClient.h>
#include <thread>
#include <chrono>
#include <algorithm>

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";
    /* BucketName を、ご利用のバケットの名前に設定します (例: examplebucket)。 */
    std::string BucketName = "examplebucket";
    /* ObjectName を、アーカイブオブジェクトの完全なパスに設定します。 パスにバケット名は含めません。 */
    std::string ObjectName = "yourObjectName";
  
    /* ネットワークリソースを初期化します。 */
    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);
  
    /* アーカイブオブジェクトを解凍します。 */
    auto outcome = client.RestoreObject(BucketName, ObjectName);
    /* アーカイブストレージクラスにないオブジェクトは解凍できません。 */
    if (!outcome.isSuccess()) {
        /* 例外を処理します。 */
        std::cout << "RestoreObject fail, code: " << outcome.error().Code() <<
        ", message: " << outcome.error().Message() <<
        ", requestId: " << outcome.error().RequestId() << std::endl;
        return -1;
    }
    std::string onGoingRestore("ongoing-request=\"false\"");
    int maxWaitTimeInSeconds = 600;
    while (maxWaitTimeInSeconds > 0)
    {
        auto meta = client.HeadObject(BucketName, ObjectName);
        std::string restoreStatus = meta.result().HttpMetaData()["x-oss-restore"];
        std::transform(restoreStatus.begin(), restoreStatus.end(), restoreStatus.begin(), ::tolower);
        if (!restoreStatus.empty() && 
        restoreStatus.compare(0, onGoingRestore.size(), onGoingRestore)==0) {
            std::cout << " success, restore status:" << restoreStatus << std::endl;
            /* アーカイブオブジェクトは正常に解凍されました。 */
            break;
        }
        std::cout << " info, WaitTime:" << maxWaitTimeInSeconds
        << "; restore status:" << restoreStatus << std::endl;
        std::this_thread::sleep_for(std::chrono::seconds(10));
        maxWaitTimeInSeconds--;     
    }
    if (maxWaitTimeInSeconds == 0)
    {
        std::cout << "RestoreObject fail, TimeoutException" << std::endl;
    }
    /* ネットワークリソースを解放します。 */
    ShutdownSdk();
    return 0;
}

コールドアーカイブオブジェクトの解凍

次のコードは、コールドアーカイブオブジェクトを解凍する方法の例です。

#include <alibabacloud/oss/OssClient.h>
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";
    /* BucketName を、ご利用のバケットの名前に設定します (例: examplebucket)。 */
    std::string BucketName = "examplebucket";
    /* ObjectName を、コールドアーカイブオブジェクトの完全なパスに設定します。 パスにバケット名は含めません。 */
    std::string ObjectName = "yourObjectName";

    /* ネットワークリソースを初期化します。 */
    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);

    /* ファイルのアップロード時にストレージクラスをコールドアーカイブとして指定するには、次のコードをご参照ください。 */
    //auto content = std::make_shared<std::stringstream>("test");
    //PutObjectRequest putRequest(BucketName, ObjectName, content);
    //putRequest.MetaData().addHeader("x-oss-storage-class", "ColdArchive");
    //auto putOutcome = client.PutObject(putRequest);

    RestoreObjectRequest request(BucketName, ObjectName);
    /* オブジェクトが解凍状態で保持される日数を設定します。 デフォルト値は 1 です。 */
    request.setDays(2);
    /* コールドアーカイブオブジェクトの解凍優先度を設定します。 TierType::Bulk は、解凍が 5～12 時間以内に完了することを示します。 */
    request.setTierType(TierType::Bulk);
    auto outcome = client.RestoreObject(request);

    if (!outcome.isSuccess()) {
        /* 例外を処理します。 */
        std::cout << "Delete Bucket Inventory fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
    }

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

Object Storage Service:ファイルの解凍 (C++ SDK)

注意事項

アーカイブオブジェクトの解凍

コールドアーカイブオブジェクトの解凍

関連ドキュメント