歸檔或冷歸檔類型的Object需要解凍(Restore)之後才能讀取。本文介紹如何解凍歸檔和冷歸檔Object。
注意事項
僅歸檔、冷歸檔類型的Object支援調用RestoreObject方法。
本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見訪問網域名稱和資料中心。
本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見初始化。
要解凍檔案,您必須有
oss:RestoreObject
許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。
解凍歸檔Object
以下代碼用於解凍歸檔Object:
using Aliyun.OSS;
using Aliyun.OSS.Model;
using Aliyun.OSS.Model;
using System.Net;
using System.Text;
// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為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");
// 填寫Bucket名稱。
var bucketName = "examplebucket";
// 填寫不包含Bucket名稱在內的歸檔類型Object的完整路徑。
var objectName = "yourObjectName";
// 自訂Object內容。
var objectContent = "More than just cloud.";
int maxWaitTimeInSeconds = 600;
// 建立OssClient執行個體。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
try
{
// 建立Archive Storage空間。
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;
}
// 解凍歸檔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);
// 最長等待時間減少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;
// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為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");
// 填寫Bucket名稱。
var bucketName = "examplebucket";
// 填寫不包含Bucket名稱在內的冷歸檔類型Object的完整路徑。
var objectName = "yourObjectName";
// 建立OssClient執行個體。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
// 解凍冷歸檔Object。
var request = new RestoreObjectRequest(bucketName, objectName);
// 設定解凍冷歸檔檔案的優先順序。
// TierType.Expedited 表示1小時內完成解凍。
// TierType.Standard 表示2~5小時內完成解凍。
// TierType.Bulk 表示5~12小時內完成解凍。
// 配置解凍參數,以設定1小時內完成解凍,解凍狀態保持2天為例。
// 第一個參數Days表示保持解凍狀態的天數,預設是1天,此參數適用於解凍Archive(歸檔)與ColdArchive(冷歸檔)類型檔案。
// 第二個參數Tier表示解凍優先順序,只適用於解凍ColdArchive類型檔案。
request.Days = 2;
request.Tier = TierType.Bulk;
RestoreObjectResult result = client.RestoreObject(request);
Console.WriteLine("RestoreObject result HttpStatusCode : {0}", result.HttpStatusCode);
相關文檔
關於解凍歸檔和冷歸檔Object的完整範例程式碼,請參見GitHub樣本。
關於解凍歸檔和冷歸檔Object的API介面描述,請參見RestoreObject。