如何通过Go SDK V2转换文件的存储类型_对象存储(OSS)-阿里云帮助中心

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

注意事项

本文示例代码以华东 1（杭州）的地域 ID cn-hangzhou 为例，默认使用外网 Endpoint，如果您希望通过与 OSS 同地域的其他阿里云产品访问 OSS，请使用内网 Endpoint。关于 OSS 支持的 Region 与 Endpoint 的对应关系，请参见 OSS 地域和访问域名。
本文以从环境变量读取访问凭证为例。如何配置访问凭证，请参见配置访问凭证。
要转换文件存储类型，您必须具有 oss:GetObject 、 oss:PutObject 和 oss:RestoreObject 权限。具体操作，请参见为 RAM 用户授予自定义的权限策略。

示例代码

（推荐）使用拷贝管理器（Copier）转换文件类型

推荐您使用 Go SDK V2 新增的拷贝管理器中 Copier.Copy 方法进行文件类型转换，此方法组合了简单拷贝和分片拷贝接口，并且可根据拷贝的请求参数自动选择合适的接口去转换文件类型。

以下代码展示了如何使用 Copier.Copy 方法将标准存储类型的 object 转换成归档类型。

package main
import (
	"context"
	"flag"
	"log"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
// 定义全局变量
var (
	region         string // 存储区域
	srcBucketName  string // 源存储空间名称
	srcObjectName  string // 源对象名称
	destBucketName string // 目标存储空间名称
	destObjectName string // 目标对象名称
// init函数用于初始化命令行参数
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&srcBucketName, "src-bucket", "", "The name of the source bucket.")
	flag.StringVar(&srcObjectName, "src-object", "", "The name of the source object.")
	flag.StringVar(&destBucketName, "dest-bucket", "", "The name of the destination bucket.")
	flag.StringVar(&destObjectName, "dest-object", "", "The name of the destination object.")
func main() {
	// 解析命令行参数
	flag.Parse()
	// 检查源存储空间名称是否为空
	if len(srcBucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	// 检查存储区域是否为空
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	// 如果目标存储空间名称未指定，则使用源存储空间名称
	if len(destBucketName) == 0 {
		destBucketName = srcBucketName
	// 检查源对象名称是否为空
	if len(srcObjectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, src object name required")
	// 检查目标对象名称是否为空
	if len(destObjectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, destination object name required")
	// 配置OSS客户端
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)
	// 创建OSS客户端
	client := oss.NewClient(cfg)
	// 创建文件拷贝器
	c := client.NewCopier()
	// 构建拷贝对象的请求
	request := &oss.CopyObjectRequest{
		Bucket:       oss.Ptr(destBucketName), // 目标存储空间名称
		Key:          oss.Ptr(destObjectName), // 目标对象名称
		SourceKey:    oss.Ptr(srcObjectName),  // 源对象名称
		SourceBucket: oss.Ptr(srcBucketName),  // 源存储空间名称
		StorageClass: oss.StorageClassArchive, // 指定存储类型为归档类型
	// 执行拷贝对象的操作
	result, err := c.Copy(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to copy object %v", err) // 如果拷贝失败，记录错误并退出
	// 打印拷贝对象的结果
	log.Printf("copy object result:%#v\n", result)

使用简单拷贝（CopyObject）转换文件类型

您可以使用简单拷贝 CopyObject 方法将标准存储类型的 object 转换成归档类型。

package main
import (
	"context"
	"flag"
	"log"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
// 定义全局变量
var (
	region         string // 存储区域
	bucketName     string // 源存储空间名称
	objectName     string // 源对象名称
	destBucketName string // 目标存储空间名称
	destObjectName string // 目标对象名称
// init函数用于初始化命令行参数
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the source bucket.")
	flag.StringVar(&objectName, "src-object", "", "The name of the source object.")
	flag.StringVar(&destBucketName, "dest-bucket", "", "The name of the destination bucket.")
	flag.StringVar(&destObjectName, "dest-object", "", "The name of the destination object.")
func main() {
	// 解析命令行参数
	flag.Parse()
	// 检查源bucket名称是否为空
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, source bucket name required")
	// 检查region是否为空
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	// 如果目标bucket名称未指定，则使用源bucket名称
	if len(destBucketName) == 0 {
		destBucketName = bucketName
	// 检查源object名称是否为空
	if len(objectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, source object name required")
	// 检查目标object名称是否为空
	if len(destObjectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, destination object name required")
	// 加载默认配置并设置凭证提供者和区域
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)
	// 创建OSS客户端
	client := oss.NewClient(cfg)
	// 创建复制对象请求
	copyRequest := &oss.CopyObjectRequest{
		Bucket:       oss.Ptr(destBucketName), // 目标存储空间名称
		Key:          oss.Ptr(destObjectName), // 目标对象名称
		SourceKey:    oss.Ptr(objectName),     // 源对象名称
		SourceBucket: oss.Ptr(bucketName),     // 源存储空间名称
		StorageClass: oss.StorageClassArchive, // 转换存储类型为归档类型
	// 执行复制对象操作并处理结果
	copyResult, err := client.CopyObject(context.TODO(), copyRequest)
	if err != nil {
		log.Fatalf("failed to copy object: %v", err)
	log.Printf("copy object result: %#v\n", copyResult)

注意事项

示例代码

（推荐）使用拷贝管理器（Copier）转换文件类型

使用简单拷贝（CopyObject）转换文件类型

相关文档