文档

Go转换文件存储类型

更新时间:

OSS提供标准、低频访问、归档、冷归档和深度冷归档多种存储类型,全面覆盖从热到冷的各种数据存储场景。本文主要介绍如何转换文件(Object)的存储类型。

注意事项

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

  • 本文以从环境变量读取访问凭证为例。如何配置访问凭证,请参见配置访问凭证

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

  • 要转换文件存储类型,您必须具有oss:GetObjectoss:PutObjectoss:RestoreObject权限。具体操作,请参见为RAM用户授权自定义的权限策略

示例代码

以下提供了详细的示例代码用于Object存储类型的相互转换。

  • 以下代码用于将Object的存储类型从标准或低频访问转换为归档类型:

    package main
    
    import (
        "fmt"
        "os"
    
        "github.com/aliyun/aliyun-oss-go-sdk/oss"
    )
    
    func main() {
        /// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        provider, err := oss.NewEnvironmentVariableCredentialsProvider()
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    
        // 创建OSSClient实例。
        // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
        client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
        // yourBucketName填写存储空间名称。
        bucketName := "yourBucketName"
        // yourObjectName填写不包含Bucket名称在内的Object的完整路径。
        objectName := "yourObjectName"
        bucket, err := client.Bucket(bucketName)
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    
        // 更改文件存储类型,例如修改为归档存储类型。
        _, err = bucket.CopyObject(objectName, objectName, oss.ObjectStorageClass(oss.StorageArchive))
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    }
  • 以下代码用于将Object的存储类型从归档转换为标准类型:

    package main
    
    import (
        "fmt"
        "os"
        "time"
    
        "github.com/aliyun/aliyun-oss-go-sdk/oss"
    )
    
    func main() {
        /// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        provider, err := oss.NewEnvironmentVariableCredentialsProvider()
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    
        // 创建OSSClient实例。
        // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
        client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
        // yourBucketName填写存储空间名称。
        bucketName := "yourBucketName"
        // yourObjectName填写不包含Bucket名称在内的Object的完整路径。
        objectName := "yourObjectName"
    
        bucket, err := client.Bucket(bucketName)
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    
        // 检查目标文件是否为归档类型。如果是,则需要先解冻才能更改存储类型。
        meta, err := bucket.GetObjectDetailedMeta(objectName)
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    
        fmt.Println("X-Oss-Storage-Class : ", meta.Get(oss.HTTPHeaderOssStorageClass))
        if meta.Get(oss.HTTPHeaderOssStorageClass) == string(oss.StorageArchive) {
            // 解冻文件。
            err = bucket.RestoreObject(objectName)
            if err != nil {
                fmt.Println("Error:", err)
                os.Exit(-1)
            }
    
            // 等待解冻结束,预计1分钟。
            meta, err = bucket.GetObjectDetailedMeta(objectName)
            for meta.Get("X-Oss-Restore") == "ongoing-request=\"true\"" {
                fmt.Println("X-Oss-Restore:" + meta.Get("X-Oss-Restore"))
                time.Sleep(1 * time.Second)
                meta, err = bucket.GetObjectDetailedMeta(objectName)
            }
        }
    
        // 更改已解冻文件的存储类型,例如修改为标准存储类型。
        _, err = bucket.CopyObject(objectName, objectName, oss.ObjectStorageClass(oss.StorageStandard))
        if err != nil {
            fmt.Println("Error:", err)
            os.Exit(-1)
        }
    }

相关文档

关于转换文件存储类型的API接口说明,请参见CopyObject

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