アーカイブオブジェクトのリアルタイムアクセスを有効にするか、復元後にアーカイブオブジェクトにアクセスできます。 リアルタイムアクセスは、Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトではサポートされていません。 Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトは、復元後にのみアクセスできます。 ほとんどの場合、アーカイブオブジェクトの復元は完了するまでに数分かかり、コールドアーカイブオブジェクトの復元は完了するまでに数時間かかり、ディープコールドアーカイブオブジェクトの復元は完了するまでに12〜48時間かかります。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。 このトピックでは、アーカイブ、コールドアーカイブ、およびDeep Cold Archiveオブジェクトを復元する方法について説明します。
処理中
次の復元プロセスは、アーカイブオブジェクト、Cold Archiveオブジェクト、およびDeep Cold Archiveオブジェクトに適用されます。
最初は、オブジェクトは凍結状態にある。
オブジェクトを復元するリクエストを送信すると、オブジェクトは復元状態になります。
Object Storage Service (OSS) サーバーが復元タスクを完了すると、オブジェクトは復元された状態になり、アクセスできます。
復元された状態のオブジェクトに対して別の復元要求を開始して、オブジェクトの復元された状態の期間を延長できます。 オブジェクトの復元された状態の期間は、対応するストレージクラスでサポートされている最大期間を超えることはできません。
復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。
復元時間
次の表に、異なるストレージクラスのオブジェクトを復元するために必要な時間を示します。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。
ストレージクラス | 復元時間 |
アーカイブ | 1 分 |
コールドアーカイブ ① |
|
ディープコールドアーカイブ ② |
|
① 1つのリージョンで、Alibaba Cloudアカウントは1秒あたり平均500個のCold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり100テラバイトから120テラバイトの範囲です。 より高いデータ取得要件がある場合は、 チケットを起票し、サポートセンターにお問い合わせください。
② 単一のリージョンで、Alibaba Cloudアカウントは1秒あたり平均100個のDeep Cold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり10テラバイトから15テラバイトの範囲です。 より高いデータ取得要件がある場合は、 チケットを起票し、サポートセンターにお問い合わせください。
復元された状態の期間
次の表に、さまざまなストレージクラスのオブジェクトの復元状態の期間を示します。
ストレージクラス | 復元された状態の期間 |
アーカイブ | 1から7までの整数。 単位:日 |
コールドアーカイブ | 1から365までの整数。 単位:日 |
ディープコールドアーカイブ | 1から365までの整数。 単位:日 |
使用上の注意
RestoreObject操作は、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトにのみ適用されます。 この操作は、標準または低頻度アクセス (IA) オブジェクトには適用されません。
Archiveオブジェクト、Cold Archiveオブジェクト、またはDeep Cold Archiveオブジェクトに対して初めてRestoreObject操作を呼び出すと、HTTP 202のステータスコードが返されます。 復元されたオブジェクトに対してRestoreObject操作を呼び出すと、200 OKが返されます。
復元状態のオブジェクトに対するRestoreObject操作は、HTTP 409エラーコードで失敗します。 オブジェクトの復元後、オブジェクトに対して別のRestoreObject操作を正常に呼び出すことができます。
バージョン管理が有効なバケットでは、オブジェクトの異なるバージョンのストレージクラスが異なる場合があります。 既定では、オブジェクトに対してRestoreObject操作を呼び出すと、オブジェクトの現在のバージョンが復元されます。 リクエストでバージョンIDを指定して、オブジェクトの特定のバージョンを復元できます。
課金ルール
Archive、Cold Archive、およびDeep Cold Archiveオブジェクトを復元すると、データ取得料金が発生します。 詳細については、「データ処理料金」をご参照ください。
アーカイブオブジェクトは最大7日間復元された状態を維持でき、コールドアーカイブまたはディープコールドアーカイブオブジェクトは最大365日間復元された状態を維持できます。 プロセス中にデータ取得料金が再度請求されることはありません。
オブジェクトの復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。 凍結状態に戻った後にオブジェクトを復元すると、データ取得料金が発生します。
Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づくレプリカの一時ストレージに対して課金されます。 詳細については、「一時ストレージ料金」をご参照ください。
OSSコンソールの使用
OSSコンソールを使用して、特定のディレクトリ内の複数のオブジェクトを一度に復元することはできません。 特定のディレクトリ内の複数のオブジェクトを一度に復元する場合は、ossutil、OSS SDK、またはRESTful APIを使用できます。
OSSコンソールにログインします。
左側のナビゲーションウィンドウで、バケットリスト をクリックします。 [バケット] ページで、目的のバケットを見つけてクリックします。
左側のナビゲーションツリーで、ファイル > オブジェクト を選択します。
復元するオブジェクトを見つけて、[操作] 列で > [復元] を選択します。
アーカイブ
修復には約1分かかります。 完了後、オブジェクトは復元された状態になります。
デフォルトでは、復元されたオブジェクトは1日間復元された状態のままです。 ossutil、OSS SDK、またはRESTful APIを使用して、この期間を最大7日間延長できます。 ピリオドが終了すると、オブジェクトはフリーズ状態に戻ります。
コールドアーカイブとディープコールドアーカイブ
レプリカ有効期間: オブジェクトが復元された状態のままである期間を指定します。 単位:日 デフォルト値は 1 です。 最大値: 365。 ピリオドが終了すると、オブジェクトはフリーズ状態に戻ります。
復元モード: 復元の優先順位を指定します。 オブジェクトの復元に必要な時間は、オブジェクトのサイズによって異なります。
OSS SDKの使用
次のコードは、一般的なプログラミング言語でOSS SDKを使用してオブジェクトを復元する方法の例を示しています。 他のプログラミング言語のOSS SDKを使用してオブジェクトを復元する方法の詳細については、「概要」をご参照ください。
com.aliyun.oss.ClientExceptionをインポートします。com.aliyun.oss.OSSをインポートします。impor t com.aliyun.oss.com mon.auth.*;
com.aliyun.oss.OSSClientBuilderをインポートします。com.aliyun.oss.OSSExceptionをインポートします。com.aliyun.oss.mo delをインポートします。*;
public classデモ {
public static void main(String[] args) throws Exception {
// この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// バケットの名前を指定します。 例: examplebucket.
String bucketName = "examplebucket";
// アーカイブオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。
String objectName = "exampledir/object";
// Create an OSSClient instance.
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
try {
ObjectMetadata objectMetadata = ossClient.getObjectMetadata(bucketName, objectName);
// オブジェクトがアーカイブオブジェクトかどうかを確認します。
StorageClass storageClass = objectMetadata.getObjectStorageClass();
if (storageClass == StorageClass.Archive) {
// Restore the object.
ossClient.restoreObject(bucketName, objectName);
// オブジェクトが復元されるのを待つ時間を指定します。
do {
Thread.sleep(1000);
objectMetadata = ossClient.getObjectMetadata(bucketName, objectName);
} while (!objectMetadata.isRestoreCompleted());
}
// 復元されたオブジェクトを照会します。
OSSObject ossObject = ossClient.getObject(bucketName, objectName);
ossObject.getObjectContent().close();
} catch (Exception e) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "しかし、何らかの理由でエラー応答で拒否されました。");
System.out.println("エラーメッセージ:" + oe.getErrorMessage());
System.out.println("エラーコード:" + oe.getErrorCode());
System.out.println("リクエストID:" + oe.getRequestId());
System.out.println("ホストID:" + oe.getHostId());
} catch (ClientException e) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ 「ネットワークにアクセスできないなど」;
System.out.println("エラーメッセージ:" + ce.getMessage());
} 最後に{
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';
}
OSS\OssClientを使用します。OSS\Core\OssExceptionを使用します。// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数を指定していることを確認してください。
$accessKeyId = getenv("OSS_ACCESS_KEY_ID");
$accessKeySecret = getenv("OSS_ACCESS_KEY_SECRET");
// この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。
$end point = "http://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket.
$bucket= "examplebucket";
// アーカイブオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: srcexampleobject.txt。
$object = "srcexampleobject.txt";
try {
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
// Restore the object.
$ossClient->restoreObject($bucket, $object);
} catch (OssException $e) {
printf(__FUNCTION__ . ": FAILED\n");
printf($e->getMessage()) 。 "\n");
戻ります。}
print(__FUNCTION__) 。 ": OK" 。 "\n");
const OSS = require('ali-OSS ')
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。
リージョン: 'yourRegion' 、
// Alibaba CloudアカウントのAccessKeyペアには、すべてのAPI操作に対する権限があります。 これらの資格情報を使用してOSSで操作を実行することは、リスクの高い操作です。 RAMユーザーを使用してAPI操作を呼び出したり、ルーチンのO&Mを実行することを推奨します。RAMユーザーを作成するには、RAMコンソールにログインします。
accessKeyId: 'yourAccessKeyId' 、
accessKeySecret: 'yourAccessKeySecret' 、
// バケットの名前を指定します。 例: examplebucket.
bucket: 'examplebucket' 、});
// 復元するアーカイブオブジェクトの名前を指定します。 例: exampleobject.txt。
client.restore('exampleobject.txt ').then((res) => {
console.log(res);
}).catch(err => {
console.log(err);
})
# -*-コーディング: utf-8 -*-
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
oss2.modelsからRestoreConfigurationをインポート
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。
# バケットの名前を指定します。 例: examplebucket.
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# Archiveオブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。
objectName = 'yourArchiveObjectName'
# オブジェクトが復元された状態のままである時間を指定します。 デフォルト値は 1 です。 単位:日。 この例では、期間は2日です。
日=2
restore_config= RestoreConfiguration(days=days)
# RestoreObjectリクエストを開始します。
Aliyun.OSSを使用したbucket.restore_object(objectName, input=restore_config)
;
Aliyun.OSS.Model; を使用
Aliyun.OSS.Model; を使用
System.Netを使用する。System.Textを使用する。// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。
var endpoint = "yourEndpoint";
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "examplebucket";
// オブジェクトのフルパスを指定します。 パスにバケット名を含めることはできません。
var objectName = "yourObjectName";
// オブジェクトのコンテンツを指定します。
var objectContent = "単なるクラウドではありません。";
int maxWaitTimeInSeconds = 600;
// OSSClientインスタンスを作成します。
var client = new OssClient (エンドポイント、accessKeyId、accessKeySecret);
トライ
{
// アーカイブバケットを作成します。
var bucket = client.CreateBucket(bucketName, StorageClass.Archive);
Console.WriteLine("Create Archive bucket successed, {0} ", bucket.Name);
}
キャッチ (例外ex)
{
Console.WriteLine("Create Archive bucket failed, {0}", ex.Message);
}
// オブジェクトをバケットにアップロードし、オブジェクトのストレージクラスをArchiveに設定します。
トライ
{
byte[] binaryData = Encoding.ASCII.GetBytes(objectContent);
MemoryStream requestContent = new MemoryStream(binaryData);
client.PutObject(bucketName, objectName, requestContent);
Console.WriteLine("Put object successed, {0}", objectName);
}
キャッチ (例外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);
戻ります。}
// アーカイブオブジェクトを復元します。
RestoreObjectResult result = client.RestoreObject(bucketName, objectName);
Console.WriteLine("RestoreObject result HttpStatusCode : {0}", result.HttpStatusCode);
if (result.HttpStatusCode != HttpStatusCode.Accepted)
{
新しい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("継続的-要求=\" false\"", StringComparison.InvariantCultureIgnoreCase))
{
break;
}
Thread.sleep(1000);
// 最大待機時間は1秒減少します。
maxWaitTimeInSeconds --;
}
if (maxWaitTimeInSeconds == 0)
{
Console.WriteLine("RestoreObject is timeout. ");
新しいTimeoutException() をスローします。}
else
{
Console.WriteLine("RestoreObject is successful. ");
}
// アーカイブオブジェクトを復元します。
RestoreObjectRequest restore = new RestoreObjectRequest();
// バケットの名前を指定します。 例: examplebucket.
restore.setBucketName("examplebucket");
// オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: exampledir/exampleobject.txt。
restore.setObjectKey("exampledir/exampleobject.txt");
OSSAsyncTask task = oss.asyncRestoreObject(restore, new OSSCompletedCallback<RestoreObjectRequest,
RestoreObjectResult>() {
@オーバーライド
public void onSuccess(RestoreObjectRequestリクエスト, RestoreObjectResult結果) {
OSSLog.logInfo("code::" + result.getStatusCode());
}
@オーバーライド
public void onFailure(RestoreObjectRequest request, ClientException clientException,
ServiceException serviceException) {
OSSLog.logError("error: " + serviceException.getRawMessage());
}
});
task.waitUntilFinished();
パッケージメイン
import (import (import)
"fmt"
"os"
"strings"
"time",
「github.com/aliyun/aliyun-oss-go-sdk/oss」
)
func HandleError (エラーエラー) {
fmt.Println("Error:", err)
os.Exit(-1)
}
func main() {
/// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// Create an OSSClient instance.
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。
client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
HandleError(err)
}
// バケットの名前を指定します。 例: examplebucket.
bucketName := "examplebucket"
// オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: exampledir/exampleobject.txt。
objectName := "exampledir/exampleobject.txt"
// ローカルファイルのフルパスを指定します。 例: D :\\ localpath\\examplefile.txt。
localFilename := "D :\\ localpath\\examplefile.txt"
// バケットを作成します。
err = client.CreateBucket(bucketName, oss.StorageClass(oss.StorageArchive))
if err! =nil {
HandleError(err)
}
archiveBucket, err := client.Bucket(bucketName)
if err! =nil {
HandleError(err)
}
// ローカルファイルをアップロードします。
var val = "More than just cloud."
err = archiveBucket.PutObject(objectName, strings.NewReader(val))
if err! =nil {
HandleError(err)
}
// オブジェクトのストレージクラスを照会します。
meta, err := archiveBucket.GetObjectDetailedMeta(objectName)
if err! =nil {
HandleError(err)
}
fmt.Println("X-Oss-Storage-Class : ", meta.Get("X-Oss-Storage-Class"))
// アーカイブオブジェクトを復元します。
err = archiveBucket.RestoreObject(objectName)
if err! =nil {
HandleError(err)
}
// アーカイブオブジェクトが復元されるまで待ちます。
meta, err = archiveBucket.GetObjectDetailedMeta(objectName)
if err! =nil {
HandleError(err)
}
for meta.Get("X-Oss-Restore") == "ongoing-request=\"true\"" {
fmt.Println("x-oss-restore:" + meta.Get("X-Oss-Restore"))
time.Sleep(10 * time.Second)
meta, err = archiveBucket.GetObjectDetailedMeta(objectName)
if err! =nil {
HandleError(err)
}
}
fmt.Println("x-oss-restore:" + meta.Get("X-Oss-Restore"))
// Download the restored object.
err = archiveBucket.GetObjectToFile(objectName, localFilename)
if err! =nil {
HandleError(err)
}
// オブジェクトの復元操作を再度実行します。 オブジェクトが復元された状態のままである期間は、24時間延長されます。
err = archiveBucket.RestoreObject(objectName)
if err! =nil {
HandleError(err)
}
fmt.Println("ArchiveSample completed")
}
OSSRestoreObjectRequest * request = [OSSRestoreObjectRequest new];
// バケットの名前を指定します。 例: examplebucket.
request.bucketName = @ "examplebucket";
// オブジェクトのフルパスを指定します。 フルパスにバケット名を含めることはできません。 例: exampleobject.txt。
request.objectKey = @ "exampleobject.txt";
OSSTask * restoreObjectTask = [client restoreObject:request];
[restoreObjectTask continueWithBlock:^ id _Nullable(OSSTask * _Nonnullタスク) {
if (!task.error) {
NSLog(@ "オブジェクトの復元成功");
} else {
NSLog(@ "restore object failed, error: % @", task.error);
}
nilを返します。}];
#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を返します。}
#include "oss_api.h"
# 「aos_http_io.h」を含める
/* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 * /
const char * endpoint = "yourEndpoint";
/* バケットの名前を指定します。 例: examplebucket. * /
const char * bucket_name = "examplebucket";
/* オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: exampledir/exampleobject.txt。 * /
const char * object_name = "exampledir/exampleobject.txt";
void init_options(oss_request_options_t * オプション)
{
options->config = oss_config_create(options->pool);
/* char * stringを使用して、aos_string_t型のデータを初期化します。 */
aos_str_set(&options->config->endpoint, endpoint);
/* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
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"));
/* CNAMEを使用するかどうかを指定します。 値0は、CNAMEが使用されないことを示す。 */
options->config->is_cname = 0;
/* タイムアウト時間などのネットワークパラメーターを指定します。 */
options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char * argv[])
{
/* main() でaos_http_io_initializeメソッドを呼び出して、ネットワークリソースやメモリリソースなどのグローバルリソースを初期化します。 */
if (aos_http_io_initialize(NULL, 0))! =AOSE_OK) {
exit(1);
}
/* メモリを管理するためのメモリプールを作成します。 aos_pool_tはapr_pool_tと同じです。 メモリプールの作成に使用されるコードは、APRライブラリに含まれています。 */
aos_pool_t *pool;
/* メモリプールを作成します。 2番目のパラメーターの値はNULLです。 この値は、プールが他のメモリプールを継承しないことを示します。 */
aos_pool_create(&pool, NULL);
/* Create and initialize options. このパラメーターには、エンドポイント、access_key_id、access_key_secret、is_cname、curlなどのグローバル構成情報が含まれます。 */
oss_request_options_t *oss_client_options;
/* メモリプール内のメモリリソースをオプションに割り当てます。 */
oss_client_options = oss_request_options_create(pool);
/* oss_client_optionsを初期化します。 */
init_options(oss_client_options);
/* パラメーターを初期化します。 */
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);
/* オブジェクトを復元します。 */
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);
/* メモリプールを解放します。 この操作により、リクエストに割り当てられたメモリリソースが解放されます。 */
aos_pool_destroy(pool);
/* 割り当てられたグローバルリソースを解放します。 */
aos_http_io_deinitialize();
0を返します。}
ossutilの使用
ossutilを使用して、Archive、Cold Archive、およびDeep Cold Archiveオブジェクトを復元できます。 詳細については、「restore」をご参照ください。
RESTful APIの使用
ビジネスで高度なカスタマイズが必要な場合は、RESTful APIを直接呼び出すことができます。 APIを直接呼び出すには、コードに署名計算を含める必要があります。 詳細については、「RestoreObject」をご参照ください。
よくある質問
オブジェクトが復元されたかどうかを判断する方法は?
アーカイブオブジェクト、Cold Archiveオブジェクト、またはDeep Cold Archiveオブジェクトに対してRestoreObject操作を呼び出した後、ListObjects (GetBucket) 、ListObjectV2 (GetBucketV2) 、またはListObjectVersions (GetBucketVersions) 操作を呼び出して、オブジェクトが復元されているかどうかを確認できます。