全部文档
当前文档
最近更新时间：2025-03-11 19:53:13
CopyFile方法适用于在同一个桶或同Region的不同桶之间复制文件，使用该方法时无需关心复制的文件大小，SDK将自动根据文件大小进行分块复制。
package main
import (
"fmt"
"github.com/ks3sdklib/aws-sdk-go/aws"
"github.com/ks3sdklib/aws-sdk-go/aws/awsutil"
"github.com/ks3sdklib/aws-sdk-go/aws/credentials"
"github.com/ks3sdklib/aws-sdk-go/service/s3"
)
func main() {
// 创建访问凭证，请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建S3Client，更多配置项请查看Go-SDK初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 填写您的Region
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 填写您的Endpoint
})
// 填写目标存储空间名称
bucket := "<bucket_name>"
// 填写目标对象的key
key := "<object_key>"
// 填写源存储空间名称
sourceBucket := "<source_bucket_name>"
// 填写源对象的key
sourceKey := "<source_object_key>"
// 高级复制
resp, err := client.CopyFile(&s3.CopyFileInput{
Bucket: aws.String(bucket), // 目标存储空间名称，必填
Key: aws.String(key), // 目标对象的key，必填
SourceBucket: aws.String(sourceBucket), // 源存储空间名称，必填
SourceKey: aws.String(sourceKey), // 源对象的key，必填
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}
1. 支持断点续传，每块复制完成后SDK会记录到断点文件中，再次复制该文件时，会自动恢复上次的复制进度。
2. 支持进度回调。
3. 支持自动校验 CRC64。
package main
import (
"fmt"
"github.com/ks3sdklib/aws-sdk-go/aws"
"github.com/ks3sdklib/aws-sdk-go/aws/awsutil"
"github.com/ks3sdklib/aws-sdk-go/aws/credentials"
"github.com/ks3sdklib/aws-sdk-go/service/s3"
)
func main() {
// 创建访问凭证，请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建S3Client，更多配置项请查看Go-SDK初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 填写您的Region
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 填写您的Endpoint
})
// 填写目标存储空间名称
bucket := "<bucket_name>"
// 填写目标对象的key
key := "<object_key>"
// 填写源存储空间名称
sourceBucket := "<source_bucket_name>"
// 填写源对象的key
sourceKey := "<source_object_key>"
// 高级复制，设置选填项
resp, err := client.CopyFile(&s3.CopyFileInput{
Bucket: aws.String(bucket), // 目标存储空间名称，必填
Key: aws.String(key), // 目标对象的key，必填
SourceBucket: aws.String(sourceBucket), // 源存储空间名称，必填
SourceKey: aws.String(sourceKey), // 源对象的key，必填
PartSize: aws.Long(5 * 1024 * 1024), // 分块大小，选填
TaskNum: aws.Long(3), // 并发复制的分块数量，选填
EnableCheckpoint: aws.Boolean(true), // 是否开启断点续传，选填
CheckpointDir: aws.String("/root/test/checkpointDir/"), // 断点续传文件存储目录，选填
ACL: aws.String(s3.ACLPrivate), // 访问权限，选填
StorageClass: aws.String(s3.StorageClassStandard), // 存储类型，选填
MetadataDirective: aws.String("COPY"), // 指定是否拷贝源Object的元数据信息，有效值：COPY, REPLACE，默认为COPY，选填
Metadata: map[string]*string{}, // 自定义元数据，选填
TaggingDirective: aws.String("COPY"), // 指定是否拷贝源Object的标签信息，有效值：COPY, REPLACE，默认为COPY，选填
Tagging: aws.String("key1=value1&key2=value2"), // 对象标签，选填
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}以下代码用于复制时设置目标文件加密，加密方式为：KS3托管密钥的服务器端加密（SSE-S3）。
package main
import (
"fmt"
"github.com/ks3sdklib/aws-sdk-go/aws"
"github.com/ks3sdklib/aws-sdk-go/aws/awsutil"
"github.com/ks3sdklib/aws-sdk-go/aws/credentials"
"github.com/ks3sdklib/aws-sdk-go/service/s3"
)
func main() {
// 创建访问凭证，请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建S3Client，更多配置项请查看Go-SDK初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 填写您的Region
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 填写您的Endpoint
})
// 填写目标存储空间名称
bucket := "<bucket_name>"
// 填写目标对象的key
key := "<object_key>"
// 填写源存储空间名称
sourceBucket := "<source_bucket_name>"
// 填写源对象的key
sourceKey := "<source_object_key>"
// 高级复制，使用KS3托管密钥的服务器端加密 (SSE-S3）
resp, err := client.CopyFile(&s3.CopyFileInput{
Bucket: aws.String(bucket), // 目标存储空间名称，必填
Key: aws.String(key), // 目标对象的key，必填
SourceBucket: aws.String(sourceBucket), // 源存储空间名称，必填
SourceKey: aws.String(sourceKey), // 源对象的key，必填
ServerSideEncryption: aws.String("AES256"), // 使用KS3托管密钥的服务器端加密，合法值：AES256
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}以下代码用于复制时设置目标文件加密，加密方式为：客户提供加密密钥的服务器端加密（SSE-C）。
package main
import (
"fmt"
"github.com/ks3sdklib/aws-sdk-go/aws"
"github.com/ks3sdklib/aws-sdk-go/aws/awsutil"
"github.com/ks3sdklib/aws-sdk-go/aws/credentials"
"github.com/ks3sdklib/aws-sdk-go/service/s3"
)
func main() {
// 创建访问凭证，请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建S3Client，更多配置项请查看Go-SDK初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 填写您的Region
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 填写您的Endpoint
})
// 填写目标存储空间名称
bucket := "<bucket_name>"
// 填写目标对象的key
key := "<object_key>"
// 填写源存储空间名称
sourceBucket := "<source_bucket_name>"
// 填写源对象的key
sourceKey := "<source_object_key>"
// 填写您用于加密的密钥，密钥长度支持16/24/32位
SSECustomerKey := "<encryption_key>"
// 高级复制，使用客户提供的加密密钥的服务器端加密（SSE-C）
resp, err := client.CopyFile(&s3.CopyFileInput{
Bucket: aws.String(bucket), // 目标存储空间名称，必填
Key: aws.String(key), // 目标对象的key，必填
SourceBucket: aws.String(sourceBucket), // 源存储空间名称，必填
SourceKey: aws.String(sourceKey), // 源对象的key，必填
SSECustomerAlgorithm: aws.String("AES256"), // 客户端提供的加密算法，合法值：AES256
SSECustomerKey: aws.String(s3.GetBase64Str(SSECustomerKey)), // 客户端提供的加密密钥进行Base64编码后的值
SSECustomerKeyMD5: aws.String(s3.GetBase64MD5Str(SSECustomerKey)), // 客户端提供的通过BASE64编码的通过128位MD5加密的密钥的MD5值
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}以下代码用于复制源加密文件，加密方式为：客户提供加密密钥的服务器端加密（SSE-C）。
package main
import (
"fmt"
"github.com/ks3sdklib/aws-sdk-go/aws"
"github.com/ks3sdklib/aws-sdk-go/aws/awsutil"
"github.com/ks3sdklib/aws-sdk-go/aws/credentials"
"github.com/ks3sdklib/aws-sdk-go/service/s3"
)
func main() {
// 创建访问凭证，请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建S3Client，更多配置项请查看Go-SDK初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 填写您的Region
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 填写您的Endpoint
})
// 填写目标存储空间名称
bucket := "<bucket_name>"
// 填写目标对象的key
key := "<object_key>"
// 填写源存储空间名称
sourceBucket := "<source_bucket_name>"
// 填写源对象的key
sourceKey := "<source_object_key>"
// 填写您用于加密的密钥，密钥长度支持16/24/32位
SSECustomerKey := "<encryption_key>"
// 高级复制，源文件使用客户提供的加密密钥的服务器端加密（SSE-C）
resp, err := client.CopyFile(&s3.CopyFileInput{
Bucket: aws.String(bucket), // 目标存储空间名称，必填
Key: aws.String(key), // 目标对象的key，必填
SourceBucket: aws.String(sourceBucket), // 源存储空间名称，必填
SourceKey: aws.String(sourceKey), // 源对象的key，必填
CopySourceSSECustomerAlgorithm: aws.String("AES256"), // 客户端提供的加密算法，合法值：AES256
CopySourceSSECustomerKey: aws.String(s3.GetBase64Str(SSECustomerKey)), // 客户端提供的加密密钥进行Base64编码后的值
CopySourceSSECustomerKeyMD5: aws.String(s3.GetBase64MD5Str(SSECustomerKey)), // 客户端提供的通过BASE64编码的通过128位MD5加密的密钥的MD5值
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}纯净模式