本文介绍如何解冻归档文件。

    归档类型（Archive）的文件需要解冻（Restore）之后才能读取。非归档类型的文件，无需调用restoreObject方法。

    归档文件的状态变换过程如下：

    • 归档类型的文件初始时处于冷冻状态。
    • 提交解冻操作后，服务端执行解冻，文件处于解冻中的状态。
    • 完成解冻后，可以读取文件。解冻状态默认持续1天，最多延长7天，之后文件又回到冷冻状态。
      归档存储类型的详细说明请参见存储类型介绍。相关状态码的详细解释请参见API文档RestoreObject。解冻归档文件的完整代码请参见GitHub。

    以下代码用于解冻归档文件：

    1. package main
    3. import (
    4.     "fmt"
    5.     "os"
    6.     "time"
    7.     "strings"
    8.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
    9. )
    11. func HandleError(err error) {
    12.     fmt.Println("Error:", err)
    13.     os.Exit(-1)
    14. }
    16. func main() {
    17.     // 创建OSSClient实例。
    18.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
    19.     if err != nil {
    20.         HandleError(err)
    21.     }
    23.     bucketName := "<yourBucketName>"
    24.     objectName := "<yourObjectName>"
    25.     localFilename := "<yourLocalFilename>"
    27.     // 创建存储空间。
    28.     err = client.CreateBucket(bucketName, oss.StorageClass(oss.StorageArchive))
    29.     if err != nil {
    30.         HandleError(err)
    31.     }
    33.     // 获取存储空间。
    34.     archiveBucket, err := client.Bucket(bucketName)
    35.     if err != nil {
    36.         HandleError(err)
    37.     }
    39.     // 上传归档文件。
    40.     var val = "More than just cloud."
    41.     err = archiveBucket.PutObject(objectName, strings.NewReader(val))
    42.     if err != nil {
    43.         HandleError(err)
    44.     }
    46.     // 检查是否为归档类型文件。
    47.     meta, err := archiveBucket.GetObjectDetailedMeta(objectName)
    48.     if err != nil {
    49.         HandleError(err)
    50.     }
    52.     fmt.Println("X-Oss-Storage-Class : ", meta.Get("X-Oss-Storage-Class"))
    53.     if meta.Get("X-Oss-Storage-Class") == string(oss.StorageArchive) {
    54.         // 解冻归档类型文件，进入读就绪状态。
    55.         err = archiveBucket.RestoreObject(objectName)
    56.         if err != nil {
    57.             HandleError(err)
    58.         }
    60.         // 等待解冻结束。
    61.         meta, err = archiveBucket.GetObjectDetailedMeta(objectName)
    62.         for meta.Get("X-Oss-Restore") == "ongoing-request=\"true\"" {
    63.             fmt.Println("x-oss-restore:" + meta.Get("X-Oss-Restore"))
    64.             time.Sleep(1000 * time.Second)
    65.             meta, err = archiveBucket.GetObjectDetailedMeta(objectName)
    66.         }
    67.     }
    69.     // 下载已解冻的文件。
    70.     err = archiveBucket.GetObjectToFile(objectName, localFilename)
    71.     if err != nil {
    72.         HandleError(err)
    73.     }
    75.     // 再次解冻文件。
    76.     err = archiveBucket.RestoreObject(objectName)
    78.     fmt.Println("ArchiveSample completed")
    79. }