全部文档
当前文档
最近更新时间：2026-07-09 17:29:21
以下代码用于通过ListObjects列举文件：
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>", "")
// 创建KS3客户端，更多配置项请查看初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 访问地域
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 访问域名
})
// 填写存储空间名称
bucket := "<bucket_name>"
// 列举文件
resp, err := client.ListObjects(&s3.ListObjectsInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Prefix: aws.String(""), // 限定响应结果列表使用的前缀，非必填
Marker: aws.String(""), // 指定列举空间对象的起始对象，非必填
MaxKeys: aws.Long(1000), // 指定返回对象的最大数，默认为1000，非必填
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}有关ListObjects API，请参见文档：GetBucket (ListObjects) 。
以下代码用于通过ListObjectsV2列举文件：
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>", "")
// 创建KS3客户端，更多配置项请查看初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 访问地域
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 访问域名
})
// 填写存储空间名称
bucket := "<bucket_name>"
// 列举文件
resp, err := client.ListObjectsV2(&s3.ListObjectsV2Input{
Bucket: aws.String(bucket), // 存储空间名称，必填
Prefix: aws.String(""), // 指定前缀，将列举此前缀开头的对象，非必填
StartAfter: aws.String(""), // 指定列举空间对象的起始对象，非必填
MaxKeys: aws.Long(1000), // 指定返回对象的最大数，默认为1000，非必填
})
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}有关ListObjectsV2 API，请参见文档：ListObjectsV2。
以下代码用于通过分页器列举全部文件：
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>", "")
// 创建KS3客户端，更多配置项请查看初始化文档
client := s3.New(&aws.Config{
Credentials: cre, // 访问凭证
Region: "BEIJING", // 访问地域
Endpoint: "ks3-cn-beijing.ksyuncs.com", // 访问域名
})
// 填写存储空间名称
bucket := "<bucket_name>"
// 创建列举对象分页器
paginator := client.NewListObjectsPaginator(&s3.ListObjectsInput{
Bucket: aws.String(bucket), // 存储空间名称，必填
Prefix: aws.String(""), // 指定前缀，将列举此前缀开头的对象，非必填
MaxKeys: aws.Long(1000), // 指定单页返回对象的最大数，默认为1000，非必填
})
// 列举全部对象
for paginator.HasNext() {
// 列举下一页
resp, err := paginator.NextPage()
if err != nil {
panic(err)
}
fmt.Println("结果：\n", awsutil.StringValue(resp))
}
}纯净模式