Go转换文件存储类型

注意事项

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

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

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

• 要转换文件存储类型，您必须具有oss:GetObject、oss:PutObject和oss: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。