OSS提供标准、低频访问、归档和冷归档四种存储类型,全面覆盖从热到冷的各种数据存储场景。本文主要介绍如何转换文件(Object)的存储类型。
注意事项
- 本文以华东1(杭州)外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见访问域名和数据中心。
- 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient,请参见Go初始化。
- 要转换文件存储类型,您必须具有
oss:GetObject
、oss:PutObject
和oss:RestoreObject
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
示例代码
以下提供了详细的示例代码用于Object存储类型的相互转换。
- 以下代码用于将Object的存储类型从标准或低频访问转换为归档类型:
package main import ( "fmt" "os" "github.com/aliyun/aliyun-oss-go-sdk/oss" ) func main() { // 创建OSSClient实例。 // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。 // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret") 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() { // 创建OSSClient实例。 // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。 // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。 client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret") 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。