全部文档
当前文档
最近更新时间：2025-03-11 19:54:40
UploadFile方法适用于上传本地文件到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.UploadFile(&s3.UploadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
UploadFile: aws.String("/root/test/file"), // 上传文件路径，必填
})
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>"
// 高级上传，设置选填项
resp, err := client.UploadFile(&s3.UploadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
UploadFile: 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/"), // 断点续传文件保存的目录，选填
ACL: aws.String(s3.ACLPrivate), // 访问权限，选填
StorageClass: aws.String(s3.StorageClassStandard), // 存储类型，选填
Metadata: map[string]*string{}, // 自定义元数据，选填
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>"
// 高级上传，使用KS3托管密钥的服务器端加密 (SSE-S3）
resp, err := client.UploadFile(&s3.UploadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
UploadFile: aws.String("/root/test/file"), // 上传文件路径，必填
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>"
// 填写您用于加密的密钥，密钥长度支持16/24/32位
SSECustomerKey := "<encryption_key>"
// 高级上传，使用客户提供的加密密钥的服务器端加密（SSE-C）
resp, err := client.UploadFile(&s3.UploadFileInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Key: aws.String(key), // 对象的key，必填
UploadFile: 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))
}纯净模式