云服务器特惠 99/年起
  1. 腾讯云优惠网首页
  2. 腾讯云产品

图片审核 快速入门（Go SDK）

• 腾讯云产品

这篇说说腾讯云对象存储COS的XML Go SDK，涵盖源码与示例下载、环境配置（Go 1.16+）、SDK安装命令、客户端初始化及密钥设置（推荐临时密钥），并演示创建/查询存储桶、上传/查询/下载/删除对象等基础操作，支持自定义域名与CRC64校验。 初始化与密钥：通过BaseURL和AuthorizationTransport配置客户端，支持临时或永久密钥。 基础操作：提供Bucket.Put、Object.Pu。

相关产品
图片审核 产品页，含版本规格、价格与购买入口。

一、相关资源

·对象存储 COS 的 XML Go SDK 源码下载地址：XML Go SDK。

·示例 Demo 下载地址：COS XML Go SDK 示例。

·更多信息请参见 COS Go SDK API 文档。

·SDK 文档中的所有示例代码请参见 SDK 代码示例。

·SDK 更新日志请参见 ChangeLog。

·SDK 常见问题请参见：Go SDK 常见问题。

注意：说明：

注意：如果你在使用 SDK 时遇到函数或方法不存在等错误，请先将 SDK 升级到最新版再重试。

二、环境配置与准备

·Golang：用于下载和安装 Go 编译运行环境，请前往 Golang 页面进行下载。

·最低支持的 Go 版本为1.16，推荐使用最新稳定版1.24.10。

·你需要获取一个腾讯云 API 密钥，该密钥是你使用 COS SDK 各项功能的前提。

三、安装 SDK

执行以下命令安装 COS Go SDK。

go get -u github.com/tencentyun/cos-go-sdk-v5

四、初始化 COS 服务

下面为你介绍如何使用 COS Go SDK 完成一个基础操作，如初始化客户端、创建存储桶、查询存储桶列表、上传对象、查询对象列表、下载对象和删除对象。

五、初始化 COS

使用 COS 域名生成 COS Go 客户端 Client 结构。

六、方法原型

func NewClient(uri *BaseURL, httpClient *http.Client) *Client

七、参数说明

// BaseURL 访问各 API 所需的基础 URLtype BaseURL struct { // 访问 bucket, object 相关 API 的基础 URL（不包含 path 部分）: https://examplebucket-1250000000.cos.<Region>.myqcloud.com BucketURL *url.URL // 访问 service API 的基础 URL（不包含 path 部分）: https://cos.<Region>.myqcloud.com ServiceURL *url.URL // 访问 Batch API 的基础 URL （不包含 path 部分）: https://<UIN>.cos-control.<Region>.myqcloud.com BatchURL *url.URL // 访问 CI 的基础 URL （不包含 path 部分）: https://examplebucket-1250000000.ci.<Region>.myqcloud.com CIURL *url.URL}

参数名称 参数描述 类型 是否必填
BucketURL 访问 bucket, object 相关 API 的基础 URL（不包含 path 部分） *url.URL 是
ServiceURL 访问 service API 的基础 URL（不包含 path 部分） *url.URL 否
BatchURL 访问 Batch API 的基础 URL （不包含 path 部分） *url.URL 否
CIURL 访问 CI 的基础 URL （不包含 path 部分） *url.URL 否

八、设置 API 访问密钥

访问密钥是 COS SDK 访问所有服务的前提，密钥分为：临时密钥和永久密钥。

临时密钥（推荐）永久密钥临时密钥生成和使用可参见 临时密钥生成及使用指引。// 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket// COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com")b := &cos.BaseURL{BucketURL: u}// 2.临时密钥client := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ // 如果使用临时密钥需要填入，临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048 SecretID: "SECRETID", SecretKey: "SECRETKEY", SessionToken: "SECRETTOKEN", },})if client != nil { // 调用 COS 请求}// 将 examplebucket-1250000000 和 COS_REGION 修改为用户真实的信息// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket// COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com")// 用于 Get Service 查询，默认全地域 service.cos.myqcloud.comsu, _ := url.Parse("https://cos.COS_REGION.myqcloud.com")b := &cos.BaseURL{BucketURL: u, ServiceURL: su}// 1.永久密钥client := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 },})

九、配置域名

通过修改 BaseURL，可以直接使用自定义域名或者全球加速域名访问 COS。

// 使用全球加速域名访问COSu, _ := url.Parse("http://<BucketName-APPID>.cos.accelerate.myqcloud.com")b := &cos.BaseURL{BucketURL: u}// 2.临时密钥client := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ // 如果使用临时密钥需要填入，临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048 SecretID: "SECRETID", SecretKey: "SECRETKEY", SessionToken: "SECRETTOKEN", },})

十、CRC64校验（可选）

COS Go SDK 默认开启了文件上传 CRC64检验。

// 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在COS控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket// COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com")b := &cos.BaseURL{BucketURL: u}// 2.临时密钥client := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ // 如果使用临时密钥需要填入，临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048 SecretID: "SECRETID", SecretKey: "SECRETKEY", SessionToken: "SECRETTOKEN", },})// 关闭 CRC64 校验client.Conf.EnableCRC = false

十一、访问 COS 服务

创建存储桶查询存储桶列表上传对象查询对象列表下载对象删除对象入门示例如下，更多示例 Demo 请参见 GitHub 地址。package mainimport ( "context" "net/http" "net/url" "os" "github.com/tencentyun/cos-go-sdk-v5")func main() { // 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket // COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com") b := &cos.BaseURL{BucketURL: u} c := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) _, err := c.Bucket.Put(context.Background(), nil) if err != nil { panic(err) }}入门示例如下，更多示例 Demo 请参见 GitHub 地址。package mainimport ( "context" "fmt" "net/http" "os" "github.com/tencentyun/cos-go-sdk-v5")func main() { c := cos.NewClient(nil, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) s, _, err := c.Service.Get(context.Background()) if err != nil { panic(err) } for _, b := range s.Buckets { fmt.Printf("%#v\\n", b) }}入门示例如下，更多示例 Demo 请参见 GitHub 地址。package mainimport ( "context" "net/http" "net/url" "os" "strings" "github.com/tencentyun/cos-go-sdk-v5")func main() { // 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket // COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com") b := &cos.BaseURL{BucketURL: u} c := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) // 对象键（Key）是对象在存储桶中的唯一标识。 // 例如，在对象的访问域名 `examplebucket-1250000000.cos.COS_REGION.myqcloud.com/test/objectPut.go` 中，对象键为 test/objectPut.go name := "test/objectPut.go" // 1.通过字符串上传对象 f := strings.NewReader("test") _, err := c.Object.Put(context.Background(), name, f, nil) if err != nil { panic(err) } // 2.通过本地文件上传对象 _, err = c.Object.PutFromFile(context.Background(), name, "../test", nil) if err != nil { panic(err) } // 3.通过文件流上传对象 fd, err := os.Open("./test") if err != nil { panic(err) } defer fd.Close() _, err = c.Object.Put(context.Background(), name, fd, nil) if err != nil { panic(err) }}入门示例如下，更多示例 Demo 请参见 GitHub 地址。package mainimport ( "context" "fmt" "net/http" "net/url" "os" "github.com/tencentyun/cos-go-sdk-v5")func main() { // 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket // COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com") b := &cos.BaseURL{BucketURL: u} c := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) opt := &cos.BucketGetOptions{ Prefix: "test", MaxKeys: 3, } v, _, err := c.Bucket.Get(context.Background(), opt) if err != nil { panic(err) } for _, c := range v.Contents { fmt.Printf("%s, %d\\n", c.Key, c.Size) }}入门示例如下，更多示例 Demo 请参见 GitHub 地址。package mainimport ( "context" "fmt" "io" "net/http" "net/url" "os" "github.com/tencentyun/cos-go-sdk-v5")func main() { // 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket // COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com") b := &cos.BaseURL{BucketURL: u} c := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) // 1.通过响应体获取对象 name := "test/objectPut.go" resp, err := c.Object.Get(context.Background(), name, nil) if err != nil { panic(err) } bs, _ := io.ReadAll(resp.Body) resp.Body.Close() fmt.Printf("%s\\n", string(bs)) // 2.获取对象到本地文件 _, err = c.Object.GetToFile(context.Background(), name, "exampleobject", nil) if err != nil { panic(err) }}入门示例如下，更多示例 Demo 请参见 GitHub 地址。注意：对象被删除后，其对应的数据将无法再被访问。package mainimport ( "context" "net/http" "net/url" "os" "github.com/tencentyun/cos-go-sdk-v5")func main() { // 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息 // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。https://console.cloud.tencent.com/cos5/bucket // COS_REGION 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket, 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 u, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com") b := &cos.BaseURL{BucketURL: u} c := cos.NewClient(b, &http.Client{ Transport: &cos.AuthorizationTransport{ SecretID: os.Getenv("SECRETID"), // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 SecretKey: os.Getenv("SECRETKEY"), // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参考 https://cloud.tencent.com/document/product/598/37140 }, }) name := "test/objectPut.go" _, err := c.Object.Delete(context.Background(), name) if err != nil { panic(err) }}

十二、常见问题

你在使用过程中可能会碰到的一些常见问题，相关的解决办法可参见 Go SDK 常见问题。

相关内容：

  1. 图片审核 快速入门（Python SDK） 对象存储的 XML Python SDK 目前可以支持 Python 2.7 以及 Python 3.4 及以上。...
  2. 图片审核 快速入门（PHP SDK） 这篇说说腾讯云对象存储COS的XML PHP SDK下载、环境依赖（PHP 5.6+及cURL等扩展）及三种安装方式（Composer、Phar、源码），并演示初始化客户端、创建/查询存储桶、上传/查询/下载/删除对象等基础操作步骤。 环境依赖：需PHP 5.6+及cURL、xml、dom、mbstring、json扩展，低版本使用v1.3。 安装方式：推荐Composer自动安装，也可用Phar或源码方式引入aut。...
  3. 图片审核 快速入门（Node.js SDK） 通过 npm 安装环境 SDK： npm 地址。npm i cos-nodejs-sdk-v5 --save。...
  4. 图片审核 快速入门（.NET(C#) SDK） 这篇说说腾讯云COS .NET SDK的集成与使用，包括环境依赖、添加SDK、初始化客户端及创建存储桶、上传/下载/删除对象等基础操作，并建议使用临时密钥提高安全性。 集成SDK：通过Nuget安装或引用DLL，支持.NET Standard 2.0及以上。 初始化服务：创建CosXmlConfig、QCloudCredentialProvider和CosXmlServer对象，推荐单例模式。 基础操作：提供创建/查。...
  5. 图片审核 快速入门（COS iOS SDK） 1. 需要一个 iOS 应用，这个应用可以是你现有的工程，也可以是你新建的一个空的工程。2. 请确保应用基于 iOS 8.0 及以上版本的 SDK 构建。...
  6. 图片审核 快速入门（JavaScript SDK） 1. JavaScript SDK 需浏览器支持基本的 HTML5 特性（支持 IE10 以上浏览器），以便支持 ajax 上传文件和计算文件 MD5 值。...
  7. 图片审核 快速入门（小程序 SDK） 这篇说说腾讯云对象存储COS微信小程序SDK的安装、初始化、上传下载等核心操作，强调使用临时密钥保障安全，并配置域名白名单。 - 安装：支持手动或npm安装，初始化需配置密钥或getAuthorization回调。 - 上传：推荐uploadFile接口，自动选择简单或分块上传，支持进度与任务控制。 - 安全：建议使用临时密钥，遵循最小权限原则，避免泄露永久密钥。...
  8. 图片审核 快速入门（Java SDK） 正式使用前，先别急着书写第一行代码，请先花两分钟做下面的测试，确保发送的请求能够到达 COS 服务，这可以帮助你确认是否遇到了大部分用户在使用 Java SDK 时碰到的问题。...
赞 (0)
上一篇 5天前
下一篇 5天前