文档

.NET解冻文件

更新时间:

在受版本控制的存储空间(Bucket)中,文件(Object)的各个版本可以对应不同的存储类型。RestoreObject接口默认解冻Object的当前版本,允许通过指定versionId的方式来解冻指定版本的Object。

注意事项

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

  • 本文以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;
            // 创建OSSClient实例。
            var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
            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

  • 本页导读 (1)
文档反馈