Object Storage Service:オブジェクトを復元する

使用上の注意

• RestoreObject操作は、アーカイブおよびコールドアーカイブオブジェクトでのみ呼び出すことができます。

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

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

• オブジェクトを復元するには、oss:RestoreObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

Archive オブジェクトの復元

次のコードは、Archiveオブジェクトを復元する方法の例を示しています。

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

名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
    
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* バケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* アーカイブオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 */
    std::string ObjectName = "yourObjectName";
  
    /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();
    
    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);
  
    /* アーカイブオブジェクトを復元します。 */
    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("継続的-要求=\" 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.com pare (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();
    0を返します。} 

Cold Archiveオブジェクトを復元する

次のコードは、Cold Archiveオブジェクトを復元する方法の例を示しています。

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
    
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* バケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* Cold Archiveオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 */
    std::string ObjectName = "yourObjectName";

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

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

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

    RestoreObjectRequestリクエスト (BucketName, ObjectName);
    /* オブジェクトが復元された状態を維持できる期間を指定します。 単位：日 デフォルト値は 1 です。 */
    request.setDays (2);
    /* Cold Archiveオブジェクトの復元優先度を設定します。 TierType::Expeditedは、オブジェクトが1時間以内に復元されることを示します。 */
    request.setTierType(TierType::Expedited);
    auto outcome = client.RestoreObject (リクエスト);

    if (!outcome.isSuccess()) {
        /* 例外を処理します。 */
        std::cout << "バケットインベントリの削除に失敗" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
    }

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

参考資料

• アーカイブおよびコールドアーカイブオブジェクトの復元に使用される完全なサンプルコードについては、GitHubをご参照ください。

• アーカイブオブジェクトとコールドアーカイブオブジェクトを復元するために呼び出すことができるAPI操作の詳細については、「RestoreObject」をご参照ください。