.NET解冻文件

注意事项

• 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见OSS地域和访问域名。

• 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见初始化。

• 要解冻文件，您必须有oss:RestoreObject权限。具体操作，请参见为RAM用户授权自定义的权限策略。

示例代码

以下代码用于解冻文件：

using System;
using System.Threading;
using Aliyun.OSS;

namespace Samples
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
            var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
            // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
            var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
            var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
            // 填写Bucket名称，例如examplebucket。
            var bucketName = "examplebucket";
            // 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
            var objectName = "exampledir/exampleobject.txt";
            // 指定归档类型Object的版本ID。
            var versionid = "yourArchiveObjectVersionid";
            int maxWaitTimeInSeconds = 600;
            // 填写Bucket所在地域对应的Region。以华东1（杭州）为例，Region填写为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);
            c.SetRegion(region);
            var getrequest = new GetObjectMetadataRequest(bucketName, objectName)
            {
                VersionId = versionid
            };
            var metadata = client.GetObjectMetadata(getrequest);
            string storageClass = metadata.HttpMetadata["x-oss-storage-class"] as string;
            if (storageClass != "Archive")
            {
                Console.WriteLine("StorageClass is {0}", storageClass);
                return;
            }
            // 解冻文件。
            var request = new RestoreObjectRequest(bucketName, objectName)
            {
                VersionId = versionid
            };
            var result = client.RestoreObject(request);
            Console.WriteLine("RestoreObject result HttpStatusCode : {0}, versionid: {1}", result.HttpStatusCode, result.VersionId);

            while (maxWaitTimeInSeconds > 0)
            {
                var req = new GetObjectMetadataRequest(bucketName, objectName)
                {
                    VersionId = versionid
                };
                var meta = client.GetObjectMetadata(req);
                string restoreStatus = meta.HttpMetadata["x-oss-restore"] as string;
                if (restoreStatus != null && restoreStatus.StartsWith("ongoing-request=\"false\"", StringComparison.InvariantCultureIgnoreCase))
                {
                    break;
                }
                Thread.Sleep(1000);
                maxWaitTimeInSeconds--;
            }
            if (maxWaitTimeInSeconds == 0)
            {
                Console.WriteLine("RestoreObject is timeout. ");
                throw new TimeoutException();
            }
            else
            {
                Console.WriteLine("RestoreObject is successful. ");
            }
        }
    }
}

相关文档

关于解冻文件的API接口说明，请参见RestoreObject。