すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:アクセス用のアーカイブ、コールドアーカイブ、およびDeep Cold Archiveオブジェクトを復元する

最終更新日:Oct 08, 2024

Archiveオブジェクトのリアルタイムアクセスを有効にしない場合、Archiveオブジェクトは復元した後にのみアクセスできます。 Cold ArchiveオブジェクトおよびDeep Cold Archiveオブジェクトのアーカイブオブジェクトのリアルタイムアクセスを有効にすることはできません。 Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトは、復元後にのみアクセスできます。 次のアクセス操作がサポートされています: GetObject、ProcessImage、CopyObject、UploadPartCopy、SelectObject、およびPostProcessTask。 このトピックでは、アーカイブ、コールドアーカイブ、およびDeep Cold Archiveオブジェクトを復元してこれらのオブジェクトにアクセスする方法について説明します。

前提条件

  • 復元するオブジェクトのストレージクラスは、アーカイブ、コールドアーカイブ、またはディープコールドアーカイブです。 詳細については、「ストレージクラス」をご参照ください。

  • oss:RestoreObject権限が付与されています。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

使用上の注意

  • RestoreObject操作は、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトにのみ適用されます。 この操作は、標準または低頻度アクセス (IA) オブジェクトには適用されません。

  • DeleteObjectDeleteMultipleObjectsGetObjectMetaHeadObjectなどの非アクセス操作をArchive、Cold Archive、Deep Cold Archiveオブジェクトで呼び出す場合、オブジェクトを復元する必要はありません。 上記の操作では、オブジェクトが復元されると不要な料金が発生します。

  • アーカイブオブジェクト、Cold Archiveオブジェクト、またはDeep Cold Archiveオブジェクトに対して初めてRestoreObject操作を呼び出すと、HTTPステータスコード202が返されます。 復元されたオブジェクトに対してRestoreObject操作を呼び出すと、200 OKが返されます。

  • 復元状態のオブジェクトに対してRestoreObject操作を呼び出すと、操作は失敗し、HTTPステータスコード409が返されます。 オブジェクトが復元された後、オブジェクトに対してRestoreObject操作を再度呼び出すことができます。

  • バージョン管理が有効なバケットでは、オブジェクトの異なるバージョンのストレージクラスが異なる場合があります。 既定では、オブジェクトに対してRestoreObject操作を呼び出すと、オブジェクトの現在のバージョンが復元されます。 リクエストでバージョンIDを指定して、オブジェクトの特定のバージョンを復元できます。

処理中

次の復元プロセスは、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトに適用されます。

  1. 最初は、オブジェクトは凍結状態にある。

  2. オブジェクトを復元するための要求が送信された後、オブジェクトは復元状態に入ります。

  3. OSSサーバーが復元タスクを完了すると、オブジェクトは復元された状態になり、アクセスできます。

  4. 復元された状態のオブジェクトに対して別の復元要求を開始して、オブジェクトの復元された状態の期間を延長できます。 オブジェクトの復元された状態の期間は、対応するストレージクラスでサポートされている最大期間を超えることはできません。

  5. 復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。

修復時間

次の表に、異なるストレージクラスのオブジェクトを復元するために必要な時間を示します。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。

ストレージクラス

復元時間

アーカイブ

1 分

コールドアーカイブ

  • 迅速: 1時間以内

  • 標準: 2から5時間

  • バルク: 5〜12時間

ディープコールドアーカイブ

  • 迅速: 12時間以内

  • スタンダード: 48时间以内

取得されたオブジェクトの量の参照値

1つのリージョンで、Alibaba Cloudアカウントは1秒あたり平均500個のCold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり100テラバイトから120テラバイトの範囲です。 より高いデータ取得要件がある場合は、 チケットを起票し、サポートセンターにお問い合わせください。

単一のリージョンで、Alibaba Cloudアカウントは1秒あたり平均100個のDeep Cold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり10テラバイトから15テラバイトの範囲です。 より高いデータ取得要件がある場合は、 チケットを起票し、サポートセンターにお問い合わせください。

説明

取得したCold ArchiveオブジェクトとDeep Cold Archiveオブジェクトの量の参照値を超えた後も、復元リクエストを送信できます。 復元要求は待ち行列に入れられ、復元タスクが完了するのにかかる時間は、選択された優先度に対応する予想時間よりも長くなり得る。

復元された状態の期間

次の表に、さまざまなストレージクラスのオブジェクトの復元状態の期間を示します。

ストレージクラス

復元された状態の期間

アーカイブ

1から7までの整数。 単位:日

コールドアーカイブ

1から365までの整数。 単位:日

ディープコールドアーカイブ

1から365までの整数。 単位:日

課金ルール

  • 復元されたアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトのサイズに基づいて、データ取得料金が請求されます。 詳細については、「データ処理料金」をご参照ください。

  • Archiveオブジェクトを復元するときに、PUTリクエストの数に基づいてAPI操作呼び出し料金が請求されます。 詳細については、「API 操作呼び出し料金」をご参照ください。

  • Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、データ取得要求が課金されます。 詳細については、「API 操作呼び出し料金」をご参照ください。

  • 復元中および復元後のアーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトの課金ルールに基づいてストレージ料金が請求されます。 詳細については、「ストレージ料金」をご参照ください。

  • Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づくレプリカの一時ストレージに対して課金されます。 詳細については、「一時ストレージ料金」をご参照ください。

  • アーカイブオブジェクトは、最大7日間復元された状態を維持できます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトは、最大365日間復元された状態を維持できます。 オブジェクトが復元された状態の場合、データ取得料金は請求されません。

  • オブジェクトが復元状態にある期間が終了すると、オブジェクトは凍結状態に戻る。 凍結状態に戻った後にオブジェクトを復元すると、データ取得料金が発生します。

手順

OSSコンソールの使用

説明

OSSコンソールを使用して、特定のディレクトリ内の複数のオブジェクトを一度に復元することはできません。 特定のディレクトリ内の複数のオブジェクトを一度に復元する場合は、ossutil、OSS SDK、またはOSS APIを使用できます。

  1. OSSコンソールにログインします。

  2. 左側のナビゲーションウィンドウで、バケットリスト をクリックします。 [バケット] ページで、目的のバケットを見つけてクリックします。

  3. 左側のナビゲーションツリーで、ファイル>オブジェクトを選択します。

  4. 復元するオブジェクトを見つけて選択しますmore > 復元[アクション] 列に表示されます。

    • アーカイブ

      • 修復には約1分かかります。 完了後、オブジェクトは復元された状態になります。

      • デフォルトでは、復元されたオブジェクトは1日間復元された状態のままです。 ossutil、OSS SDK、またはRESTful APIを使用して、復元された状態の期間を最大7日間に延長できます。 継続時間が終了すると、オブジェクトは凍結状態に戻ります。

    • コールドアーカイブまたはディープコールドアーカイブ

      • レプリカ有効期間: 復元された状態の期間を指定します。 単位:日 デフォルト値は 1 です。 最大値: 365。 継続時間が終了すると、オブジェクトは凍結状態に戻ります。

      • 復元モード: 復元の優先順位を指定します。 オブジェクトの復元に必要な時間は、オブジェクトのサイズによって異なります。

OSS SDKの使用

次のサンプルコードでは、一般的なプログラミング言語でOSS SDKを使用してオブジェクトを復元する方法の例を示します。 他のプログラミング言語のOSS SDKを使用してオブジェクトを復元する方法の詳細については、「概要」をご参照ください。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;

public class Demo {
    public static void main(String[] args) throws Exception {
        // In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // Specify the name of the bucket. Example: examplebucket. 
        String bucketName = "examplebucket";
        // Specify the full path of the Archive object. Do not include the bucket name in the full path. 
        String objectName = "exampledir/object";

        // Create an OSSClient instance. 
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

        try {
            ObjectMetadata objectMetadata = ossClient.getObjectMetadata(bucketName, objectName);

            // Check whether the object is an Archive object. 
            StorageClass storageClass = objectMetadata.getObjectStorageClass();
            if (storageClass == StorageClass.Archive) {
                // Restore the object. 
                ossClient.restoreObject(bucketName, objectName);

                // Specify the time to wait for the object to be restored. 
                do {
                    Thread.sleep(1000);
                    objectMetadata = ossClient.getObjectMetadata(bucketName, objectName);
                } while (!objectMetadata.isRestoreCompleted());
            }

            // Query the restored object. 
            OSSObject ossObject = ossClient.getObject(bucketName, objectName);
            ossObject.getObjectContent().close();
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}           
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;

// Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
$provider = new EnvironmentVariableCredentialsProvider();
// In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// Specify the name of the bucket. Example: examplebucket. 
$bucket= "examplebucket";
// Specify the full path of the Archive object. Do not include the bucket name in the full path. Example: srcexampleobject.txt. 
$object = "srcexampleobject.txt";

try {
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
    );
    $ossClient = new OssClient($config);
    // Restore the object. 
    $ossClient->restoreObject($bucket, $object);
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");        
const OSS = require('ali-oss')

const client = new OSS({
  // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou. 
  region: 'yourRegion',
  // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  // Specify the name of the bucket. Example: examplebucket. 
  bucket: 'examplebucket',
});

// Specify the name of the Archive object that you want to restore. Example: exampleobject.txt. 
client.restore('exampleobject.txt').then((res) => {
    console.log(res);
}).catch(err => {
    console.log(err);
})
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
from oss2.models import RestoreConfiguration

# Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. 
# Specify the name of the bucket. Example: examplebucket. 
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Specify the full path of the Archive object. Do not include the bucket name in the full path. 
objectName = 'yourArchiveObjectName'
# Specify the duration for which the object remains in the restored state. Default value: 1. Unit: day. In this example, the duration is 2 days. 
days = 2
restore_config= RestoreConfiguration(days=days)
# Initiate a RestoreObject request. 
bucket.restore_object(objectName, input=restore_config)       
using Aliyun.OSS;
using Aliyun.OSS.Model;
using Aliyun.OSS.Model;
using System.Net;
using System.Text;

// Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. 
var endpoint = "yourEndpoint";
// Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// Specify the name of the bucket. 
var bucketName = "examplebucket";
// Specify the full path of the object. The path cannot contain the bucket name. 
var objectName = "yourObjectName";
// Specify the content of the object. 
var objectContent = "More than just cloud.";
int maxWaitTimeInSeconds = 600;
// Create an OSSClient instance. 
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
try
{
    // Create an Archive bucket. 
    var bucket = client.CreateBucket(bucketName, StorageClass.Archive);
    Console.WriteLine("Create Archive bucket succeeded, {0} ", bucket.Name);
}
catch (Exception ex)
{
    Console.WriteLine("Create Archive bucket failed, {0}", ex.Message);
}
// Upload the object to the bucket and set the storage class of the object to Archive. 
try
{
    byte[] binaryData = Encoding.ASCII.GetBytes(objectContent);
    MemoryStream requestContent = new MemoryStream(binaryData);
    client.PutObject(bucketName, objectName, requestContent);
    Console.WriteLine("Put object succeeded, {0}", objectName);
}
catch (Exception ex)
{
    Console.WriteLine("Put object failed, {0}", ex.Message);
}
var metadata = client.GetObjectMetadata(bucketName, objectName);
string storageClass = metadata.HttpMetadata["x-oss-storage-class"] as string;
if (storageClass != "Archive")
{
    Console.WriteLine("StorageClass is {0}", storageClass);
    return;
}
// Restore the Archive object. 
RestoreObjectResult result = client.RestoreObject(bucketName, objectName);
Console.WriteLine("RestoreObject result HttpStatusCode : {0}", result.HttpStatusCode);
if (result.HttpStatusCode != HttpStatusCode.Accepted)
{
    throw new OssException(result.RequestId + ", " + result.HttpStatusCode + " ,");
}
while (maxWaitTimeInSeconds > 0)
{
    var meta = client.GetObjectMetadata(bucketName, objectName);
    string restoreStatus = meta.HttpMetadata["x-oss-restore"] as string;
    if (restoreStatus != null && restoreStatus.StartsWith("ongoing-request=\"false\"", StringComparison.InvariantCultureIgnoreCase))
    {
        break;
    }
    Thread.Sleep(1000);
    // The maximum wait time decreases by 1 second. 
    maxWaitTimeInSeconds--;
}
if (maxWaitTimeInSeconds == 0)
{
    Console.WriteLine("RestoreObject is timeout. ");
    throw new TimeoutException();
}
else
{
    Console.WriteLine("RestoreObject is successful. ");
}
// Restore the object. 
RestoreObjectRequest restore = new RestoreObjectRequest();
// Specify the name of the bucket. Example: examplebucket. 
restore.setBucketName("examplebucket");
// Specify the full path of the object. Do not include the bucket name in the full path. Example: exampleobject.txt. 
restore.setObjectKey("exampleobject.txt");
OSSAsyncTask task = oss.asyncRestoreObject(restore, new OSSCompletedCallback<RestoreObjectRequest,
        RestoreObjectResult>() {
    @Override
    public void onSuccess(RestoreObjectRequest request, RestoreObjectResult result) {
        Log.i("info", "code::"+result.getStatusCode());

    }

    @Override
    public void onFailure(RestoreObjectRequest request, ClientException clientException,
                          ServiceException serviceException) {
        Log.e("errorMessage", "error: "+serviceException.getRawMessage());

    }
});

task.waitUntilFinished();
package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to create credentials provider: %v", err)
	}

	// Create an OSSClient instance. 
	// Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. Specify your actual endpoint. 
	client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
	if err != nil {
		log.Fatalf("Failed to create OSS client: %v", err)
	}

	// Specify the name of the bucket. Example: examplebucket. 
	bucketName := "examplebucket"
	// Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt. 
	objectName := "exampledir/exampleobject.txt"

	// Create a bucket.
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
	}

	// Restore the Archive object. 
	err = bucket.RestoreObject(objectName)
	if err != nil {
		log.Fatalf("Failed to restore object '%s': %v", objectName, err)
	}

	log.Println("ArchiveSample completed")
}
OSSRestoreObjectRequest *request = [OSSRestoreObjectRequest new];
// Specify the name of the bucket. Example: examplebucket. 
request.bucketName = @"examplebucket";
// Specify the full path of the object. Do not include the bucket name in the full path. Example: exampleobject.txt. 
request.objectKey = @"exampleobject.txt";

OSSTask *restoreObjectTask = [client restoreObject:request];
[restoreObjectTask continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
    if (!task.error) {
        NSLog(@"restore object success");
    } else {
        NSLog(@"restore object failed, error: %@", task.error);
    }
    return nil;
}];
// Implement synchronous blocking to wait for the task to complete. 
// [restoreObjectTask waitUntilFinished];
#include <alibabacloud/oss/OssClient.h>
#include <thread>
#include <chrono>
#include <algorithm>

using namespace AlibabaCloud::OSS;

int main(void)
{
    /* Initialize information about the account that is used to access OSS. */
    
    /* Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. */
    std::string Endpoint = "yourEndpoint";
    /* Specify the name of the bucket. Example: examplebucket. */
    std::string BucketName = "examplebucket";
    /* Specify the full path of the Archive object. Do not include the bucket name in the full path. */
    std::string ObjectName = "yourObjectName";
  
    /* Initialize resources such as network resources. */
    InitializeSdk();
    
    ClientConfiguration conf;
    /* Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
  
    /* Restore the Archive object. */
    auto outcome = client.RestoreObject(BucketName, ObjectName);
    /* You cannot restore objects of the non-Archive storage class. */
    if (!outcome.isSuccess()) {
        /* Handle exceptions. */
        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;
            /* The Archive object is restored. */
            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;
    }
    /* Release resources such as network resources. */
    ShutdownSdk();
    return 0;
}
#include "oss_api.h"
#include "aos_http_io.h"
/* Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. */
const char *endpoint = "yourEndpoint";
/* Specify the name of the bucket. Example: examplebucket. */
const char *bucket_name = "examplebucket";
/* Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt. */
const char *object_name = "exampledir/exampleobject.txt";
void init_options(oss_request_options_t *options)
{
    options->config = oss_config_create(options->pool);
    /* Use a char* string to initialize data of the aos_string_t type. */
    aos_str_set(&options->config->endpoint, endpoint);
    /* Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. */
    aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
    aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
    /* Specify whether to use CNAME. The value 0 indicates that CNAME is not used. */
    options->config->is_cname = 0;
    /* Specify network parameters, such as the timeout period. */
    options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char *argv[])
{
    /* Call the aos_http_io_initialize method in main() to initialize global resources, such as network resources and memory resources. */
    if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
        exit(1);
    }
    /* Create a memory pool to manage memory. aos_pool_t is equivalent to apr_pool_t. The code used to create a memory pool is included in the APR library. */
    aos_pool_t *pool;
    /* Create a memory pool. The value of the second parameter is NULL. This value indicates that the pool does not inherit other memory pools. */
    aos_pool_create(&pool, NULL);
    /* Create and initialize options. This parameter includes global configuration information, such as endpoint, access_key_id, access_key_secret, is_cname, and curl. */
    oss_request_options_t *oss_client_options;
    /* Allocate the memory resources in the memory pool to the options. */  
    oss_client_options = oss_request_options_create(pool);
    /* Initialize oss_client_options. */
    init_options(oss_client_options);
    /* Initialize the parameters. */
    aos_string_t bucket;
    aos_string_t object;   
    aos_table_t *headers = NULL;
    aos_table_t *resp_headers = NULL; 
    aos_status_t *resp_status = NULL; 
    aos_str_set(&bucket, bucket_name);
    aos_str_set(&object, object_name);
    headers = aos_table_make(pool, 0);
       
    /* Restore the object. */
    do {
        headers = aos_table_make(pool, 0);
        resp_status = oss_restore_object(oss_client_options, &bucket, &object, headers, &resp_headers);
        printf("restore object resp_status->code: %d \n", resp_status->code);
        if (resp_status->code != 409) {
            break;
        } else {
            printf("restore object is already in progress, resp_status->code: %d \n", resp_status->code);
            apr_sleep(5000);
        }
    } while (1);
    /* Release the memory pool. This operation releases the memory resources allocated for the request. */
    aos_pool_destroy(pool);
    /* Release the allocated global resources. */
    aos_http_io_deinitialize();
    return 0;
}

ossbrowserの使用

ossbrowserを使用して、OSSコンソールで実行できるのと同じバケットレベルの操作を実行できます。 ossbrowserの画面上の指示に従って、オブジェクトを復元できます。 詳細については、「ossbrowserの使用」をご参照ください。

ossutilの使用

ossutilを使用して、Archive、Cold Archive、およびDeep Cold Archiveオブジェクトを復元できます。 詳細については、「restore」をご参照ください。

OSS APIの使用

ビジネスで高度なカスタマイズが必要な場合は、OSS RESTful APIを直接呼び出すことができます。 APIを直接呼び出すには、コードに署名計算を含める必要があります。 詳細については、「RestoreObject」をご参照ください。

エラーコード

よくある質問