Go转换文件存储类型

OSS 提供多种存储类型,包括标准、低频访问、归档、冷归档和深度冷归档,以满足从热数据到冷数据的各种存储需求。在对象存储中,一旦对象被创建,其内容是不可修改的。这意味着,如果您想更改对象的存储类型,就无法直接修改原对象,而必须创建一个新的对象。因此,转换对象的存储类型需要使用 Bucket.CopyObject 方法,这一操作会通过复制原对象来实现存储类型的转换。

注意事项

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

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

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

  • 要转换文件存储类型,您必须具有oss:GetObjectoss:PutObjectoss: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