Go转换文件存储类型

注意事项

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

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

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

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

示例代码

您可以使用Bucket.CopyObject方法进行Object存储类型的相互转换，如下：

1. 将Object的存储类型从标准或低频访问转换为归档类型：

   package main
   
   import (
   	"log"
   
   	"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 {
   		log.Fatalf("Failed to create credentials provider: %v", err)
   	}
   
   	// 创建OSSClient实例。
   	// yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
   	// yourRegion填写Bucket所在地域，以华东1（杭州）为例，填写为cn-hangzhou。其它Region请按实际情况填写。
   	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
   	clientOptions = append(clientOptions, oss.Region("yourRegion"))
   	// 设置签名版本
   	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
   	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
   	if err != nil {
   		log.Fatalf("Failed to create OSS client: %v", err)
   	}
   
   	// yourBucketName填写存储空间名称。
   	bucketName := "yourBucketName" // 请替换为实际的Bucket名称
   	// yourObjectName填写不包含Bucket名称在内的Object的完整路径。
   	objectName := "yourObjectName" // 请替换为实际的对象路径
   
   	bucket, err := client.Bucket(bucketName)
   	if err != nil {
   		log.Fatalf("Failed to get bucket: %v", err)
   	}
   
   	// 更改文件存储类型，例如修改为归档存储类型。
   	_, err = bucket.CopyObject(objectName, objectName, oss.ObjectStorageClass(oss.StorageArchive))
   	if err != nil {
   		log.Fatalf("Failed to change storage class of object: %v", err)
   	}
   
   	log.Println("Storage class changed successfully.")
   }
   

2. 以下代码用于将Object的存储类型从归档转换为标准类型：

   package main
   
   import (
   	"log"
   	"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 {
   		log.Fatalf("Failed to create credentials provider: %v", err)
   	}
   
   	// 创建OSSClient实例。
   	// yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
   	// yourRegion填写Bucket所在地域，以华东1（杭州）为例，填写为cn-hangzhou。其它Region请按实际情况填写。
   	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
   	clientOptions = append(clientOptions, oss.Region("yourRegion"))
   	// 设置签名版本
   	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
   	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
   	if err != nil {
   		log.Fatalf("Failed to create OSS client: %v", err)
   	}
   
   	// yourBucketName填写存储空间名称。
   	bucketName := "yourBucketName" // 请替换为实际的Bucket名称
   	// yourObjectName填写不包含Bucket名称在内的Object的完整路径。
   	objectName := "yourObjectName" // 请替换为实际的对象路径
   
   	bucket, err := client.Bucket(bucketName)
   	if err != nil {
   		log.Fatalf("Failed to get bucket: %v", err)
   	}
   
   	// 检查目标文件是否为归档类型。如果是，则需要先解冻才能更改存储类型。
   	meta, err := bucket.GetObjectDetailedMeta(objectName)
   	if err != nil {
   		log.Fatalf("Failed to get object detailed metadata: %v", err)
   	}
   
   	log.Printf("X-Oss-Storage-Class: %s\n", meta.Get(oss.HTTPHeaderOssStorageClass))
   	if meta.Get(oss.HTTPHeaderOssStorageClass) == string(oss.StorageArchive) {
   		// 解冻文件。
   		err = bucket.RestoreObject(objectName)
   		if err != nil {
   			log.Fatalf("Failed to restore object: %v", err)
   		}
   
   		// 等待解冻结束，预计1分钟。
   		meta, err = bucket.GetObjectDetailedMeta(objectName)
   		for meta.Get("X-Oss-Restore") == "ongoing-request=\"true\"" {
   			log.Printf("X-Oss-Restore: %s\n", meta.Get("X-Oss-Restore"))
   			time.Sleep(1 * time.Second)
   			meta, err = bucket.GetObjectDetailedMeta(objectName)
   			if err != nil {
   				log.Fatalf("Failed to get object detailed metadata during restore process: %v", err)
   			}
   		}
   	}
   
   	// 更改已解冻文件的存储类型，例如修改为标准存储类型。
   	_, err = bucket.CopyObject(objectName, objectName, oss.ObjectStorageClass(oss.StorageStandard))
   	if err != nil {
   		log.Fatalf("Failed to change storage class of object: %v", err)
   	}
   
   	log.Println("Storage class changed successfully.")
   }
   

相关文档

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