すべてのプロダクト
Search

このプロダクト

    Object Storage Service:オブジェクトの解凍 (C# SDK V1)

    ドキュメントセンター

    Object Storage Service:オブジェクトの解凍 (C# SDK V1)

    最終更新日:Nov 29, 2025

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

    注意事項

    • `RestoreObject` メソッドは、アーカイブおよびコールドアーカイブのオブジェクトに対してのみ呼び出すことができます。

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

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

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

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

    次のコードは、アーカイブオブジェクトを解凍する方法を示しています。

    using Aliyun.OSS;
using Aliyun.OSS.Model;
using Aliyun.OSS.Model;
using System.Net;
using System.Text;
using Aliyun.OSS.Common;

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを 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 = "More than just cloud.";
int maxWaitTimeInSeconds = 600;
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。
const string region = "cn-hangzhou";

// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();

// 署名バージョンを V4 に設定します。
conf.SignatureVersion = SignatureVersion.V4;

// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // アーカイブバケットを作成します。
    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);
}
// オブジェクトをアップロードし、ストレージクラスをアーカイブに設定します。
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;
}
// アーカイブオブジェクトを解凍します。
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);
    // 最大待機時間を 1 秒減らします。
    maxWaitTimeInSeconds--;
}
if (maxWaitTimeInSeconds == 0)
{
    Console.WriteLine("RestoreObject is timeout. ");
    throw new TimeoutException();
}
else
{
    Console.WriteLine("RestoreObject is successful. ");
}

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

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

    using Aliyun.OSS;
using Aliyun.OSS.Model;
using Aliyun.OSS.Common;

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを 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";
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。
const string region = "cn-hangzhou";

// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();

// 署名バージョンを V4 に設定します。
conf.SignatureVersion = SignatureVersion.V4;

// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);

// コールドアーカイブオブジェクトを解凍します。
var request = new RestoreObjectRequest(bucketName, objectName);

// コールドアーカイブオブジェクトの解凍優先度を設定します。
// TierType.Expedited: オブジェクトは 1 時間以内に解凍されます。
// TierType.Standard: オブジェクトは 2～5 時間以内に解凍されます。
// TierType.Bulk: オブジェクトは 5～12 時間以内に解凍されます。
// 解凍パラメーターを設定します。 たとえば、解凍を 1 時間以内に完了するように設定し、オブジェクトを 2 日間解凍状態に保ちます。
// 最初のパラメーター Days は、オブジェクトが解凍状態を維持する日数を指定します。 デフォルト値は 1 です。 このパラメーターは、アーカイブオブジェクトとコールドアーカイブオブジェクトの両方に適用されます。
// 2 番目のパラメーター Tier は、解凍優先度を指定します。 このパラメーターは、コールドアーカイブオブジェクトにのみ適用されます。
request.Days = 2;
request.Tier = TierType.Bulk;
RestoreObjectResult result = client.RestoreObject(request);
Console.WriteLine("RestoreObject result HttpStatusCode : {0}", result.HttpStatusCode);

    関連ドキュメント

    • アーカイブおよびコールドアーカイブオブジェクトを解凍するための完全なサンプルコードについては、「GitHub の例」をご参照ください。

    • アーカイブおよびコールドアーカイブオブジェクトを解凍するための API 操作の詳細については、「RestoreObject」をご参照ください。