本文介绍如何将源Bucket中的文件（Object）复制到同一地域下相同或不同目标Bucket中。
注意事项
本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见OSS访问域名、数据中心、开放端口。
本文以从环境变量读取访问凭证为例。如何配置访问凭证，请参见配置访问凭证。
本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见初始化。
拷贝文件时，您必须拥有源文件的读权限及目标Bucket的读写权限。
拷贝文件时，您需要确保源Bucket和目标Bucket均未设置合规保留策略，否则报错The object you specified is immutable.。
不支持跨地域拷贝。例如不能将华东1（杭州）地域存储空间中的文件拷贝到华北1（青岛）地域。
示例代码
拷贝小文件
您可以通过CopyObject方法在同一个Bucket或者同一个Region下的不同Bucket之间拷贝文件，文件大小建议小于1 GB。
在同一个Bucket中拷贝文件
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)
}
// 填写Bucket名称，例如examplebucket。
bucketName := "examplebucket"
// 填写拷贝前文件的完整路径，例如srcdir/srcobject.jpg。
objectName := "srcdir/srcobject.jpg"
// 填写拷贝后文件的完整路径，例如destdir/destobject.jpg。
destObjectName := "destdir/destobject.jpg"
// 获取存储空间。
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 指定目标文件的元数据。
expires := time.Date(2049, time.January, 10, 23, 0, 0, 0, time.UTC)
tag1 := oss.Tag{
Key: "a",
Value: "1",
}
taggingInfo := oss.Tagging{
Tags: []oss.Tag{tag1},
}
options := []oss.Option{
oss.MetadataDirective(oss.MetaReplace),
oss.Expires(expires),
oss.SetTagging(taggingInfo),
// 指定复制源Object的对象标签到目标 Object。
// oss.TaggingDirective(oss.TaggingCopy),
// 指定创建目标Object时的访问权限ACL为私有。
// oss.ObjectACL(oss.ACLPrivate),
// 指定KMS托管的用户主密钥，该参数仅在x-oss-server-side-encryption为KMS时有效。
// oss.ServerSideEncryptionKeyID("9468da86-3509-4f8d-a61e-6eab1eac****"),
// 指定OSS创建目标Object时使用的服务器端加密算法。
// oss.ServerSideEncryption("AES256"),
// 指定复制源Object的元数据到目标Object。
// oss.MetadataDirective(oss.MetaCopy),
// 指定CopyObject操作时是否覆盖同名目标Object。此处设置为true，表示禁止覆盖同名Object。
// oss.ForbidOverWrite(true),
// 如果源Object的ETag值和您提供的ETag相等，则执行拷贝操作，并返回200 OK。
// oss.CopySourceIfMatch("5B3C1A2E053D763E1B002CC607C5****"),
// 如果源Object的ETag值和您提供的ETag不相等，则执行拷贝操作，并返回200 OK。
// oss.CopySourceIfNoneMatch("5B3C1A2E053D763E1B002CC607C5****"),
// 如果指定的时间早于文件实际修改时间，则正常拷贝文件，并返回200 OK。
// oss.CopySourceIfModifiedSince(time.Date(2021, time.December, 9, 7, 1, 56, 0, time.UTC)),
// 如果指定的时间等于或者晚于文件实际修改时间，则正常拷贝文件，并返回200 OK。
// oss.CopySourceIfUnmodifiedSince(time.Date(2021, time.December, 9, 7, 1, 56, 0, time.UTC)),
// 指定Object的存储类型。此处设置为Standard，表示标准存储类型。
// oss.StorageClass("Standard"),
}
// 使用指定的元数据覆盖源文件的元数据。
_, err = bucket.CopyObject(objectName, destObjectName, options...)
if err != nil {
log.Fatalf("Failed to copy object from '%s' to '%s': %v", objectName, destObjectName, err)
}
log.Printf("Successfully copied object from '%s' to '%s'", objectName, destObjectName)
}
在同一个Region下不同Bucket之间拷贝文件
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)
}
// 填写源Bucket名称，例如srcbucket。
srcBucketName := "srcbucket"
// 填写拷贝前文件的完整路径，例如srcobject.jpg。
srcObjectName := "srcobject.jpg"
// 填写拷贝后文件的完整路径，例如destobject.jpg。
dstObjectName := "destobject.jpg"
// 填写目标Bucket名称，例如destbucket。
destBucketName := "destbucket"
// 获取目标Bucket实例。
bucket, err := client.Bucket(destBucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", destBucketName, err)
}
// 将srcbucket中的srcobject.jpg文件拷贝至destbucket内的destobject.jpg文件。
_, err = bucket.CopyObjectFrom(srcBucketName, srcObjectName, dstObjectName)
if err != nil {
log.Fatalf("Failed to copy object from '%s/%s' to '%s/%s': %v", srcBucketName, srcObjectName, destBucketName, dstObjectName, err)
}
log.Printf("Successfully copied object from '%s/%s' to '%s/%s'", srcBucketName, srcObjectName, destBucketName, dstObjectName)
}
拷贝大文件
以下代码用于拷贝大文件：
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)
}
// 填写Bucket名称，例如examplebucket。
bucketName := "examplebucket"
// 获取存储空间。
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 指定拷贝前文件的完整路径，例如srcobject.txt。
objectSrc := "srcobject.txt"
// 指定拷贝后文件的完整路径，例如destobject.txt。
objectDest := "destobject.txt"
// 填写本地文件完整路径。
fileName := "D:\\localpath\\examplefile.txt"
// 分割文件为多个块。
chunks, err := oss.SplitFileByPartNum(fileName, 3)
if err != nil {
log.Fatalf("Failed to split file: %v", err)
}
// 上传文件到OSS。
err = bucket.PutObjectFromFile(objectSrc, fileName)
if err != nil {
log.Fatalf("Failed to upload object '%s' from file '%s': %v", objectSrc, fileName, err)
}
// 初始化分段上传。
imur, err := bucket.InitiateMultipartUpload(objectDest)
if err != nil {
log.Fatalf("Failed to initiate multipart upload for '%s': %v", objectDest, err)
}
var parts []oss.UploadPart
for _, chunk := range chunks {
// 设置分段上传选项。
options := []oss.Option{}
// 执行分段拷贝。
part, err := bucket.UploadPartCopy(imur, bucketName, objectSrc, chunk.Offset, chunk.Size, chunk.Number, options...)
if err != nil {
log.Fatalf("Failed to upload part %d of '%s': %v", chunk.Number, objectSrc, err)
}
parts = append(parts, part)
}
// 完成分段上传。
cmur, err := bucket.CompleteMultipartUpload(imur, parts)
if err != nil {
log.Fatalf("Failed to complete multipart upload for '%s': %v", objectDest, err)
}
log.Printf("Multipart upload completed successfully for '%s'. cmur: %v", objectDest, cmur)
}
相关文档
关于拷贝文件的完整示例代码，请参见GitHub示例。
关于拷贝小文件的API接口说明，请参见CopyObject。
关于拷贝大文件的API接口说明，请参见UploadPartCopy。
文档内容是否对您有帮助？