全部文档
当前文档
最近更新时间：2025-03-11 19:54:02
DownloadFile方法适用于从KS3下载文件到本地，使用该方法时无需关心下载的文件大小，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>"
// 高级下载
resp, err := client.DownloadFile(&s3.DownloadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
DownloadFile: aws.String("/root/test/file"), // 本地文件路径，必填
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}
1. 支持断点续传，每块下载完成后SDK会记录到断点文件中，再次下载该文件时，将自动恢复上次的下载进度。
2. 支持进度回调。
3. 支持自动校验CRC64。
4. 支持按Range下载。
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>"
// 高级下载，设置选填项
resp, err := client.DownloadFile(&s3.DownloadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
DownloadFile: aws.String("/root/test/file"), // 本地文件路径，必填
PartSize: aws.Long(5 * 1024 * 1024), // 分块大小，选填
TaskNum: aws.Long(3), // 并发下载的分块数量，选填
EnableCheckpoint: aws.Boolean(true), // 是否开启断点续传，选填
CheckpointDir: aws.String("/root/test/checkpointDir/"), // 断点续传文件保存的目录，选填
})
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>"
// 填写您用于加密的密钥，密钥长度支持16/24/32位
SSECustomerKey := "<encryption_key>"
// 高级下载，下载加密文件
resp, err := client.DownloadFile(&s3.DownloadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
DownloadFile: aws.String("/root/test/file"), // 本地文件路径，必填
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))
}纯净模式