13111186 / go-cos

腾讯云对象存储服务 COS(Cloud Object Storage) Go SDK（XML API）

go-cos

腾讯云对象存储服务 COS(Cloud Object Storage) Go SDK（API 版本：V5 版本的 XML API）。

Install

go get -u github.com/mozillazg/go-cos

推荐使用 go mod 之类的技术指定使用的 go-cos 包版本号。

Usage

package main

import (
	"context"
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
	"os"

	"github.com/mozillazg/go-cos"
)

func main() {
	b, _ := cos.NewBaseURL("https://<bucket>-<appid>.cos.<region>.myqcloud.com")
	c := cos.NewClient(b, &http.Client{
		Transport: &cos.AuthorizationTransport{
			SecretID:  os.Getenv("COS_SECRETID"),
			SecretKey: os.Getenv("COS_SECRETKEY"),
		},
	})

	name := "test/hello.txt"
	resp, err := c.Object.Get(context.Background(), name, nil)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	bs, _ := ioutil.ReadAll(resp.Body)
	fmt.Printf("%s\n", string(bs))
}

备注：

• SDK 不会自动设置超时时间，用户根据需要设置合适的超时时间（比如，设置 http.Client 的 Timeout 字段或者 Transport 字段之类的）或在需要时实现所需的超时机制（比如，通过 context 包实现）。
• 所有的 API 在 _example 目录下都有对应的使用示例（示例程序中用到的 debug 包只是调试用的不是必需的依赖）。

TODO

Service API:

• Get Service（使用示例：service/get.go）

Bucket API:

• Get Bucket（搜索文件，使用示例：bucket/get.go）
• Get Bucket ACL（使用示例：bucket/getACL.go）
• Get Bucket CORS（使用示例：bucket/getCORS.go）
• Get Bucket Location（使用示例：bucket/getLocation.go）
• Get Buket Lifecycle（使用示例：bucket/getLifecycle.go）
• Get Bucket Tagging（使用示例：bucket/getTagging.go）
• Get Bucket policy
• Put Bucket（创建 bucket，使用示例：bucket/put.go）
• Put Bucket ACL（使用示例：bucket/putACL.go）
• Put Bucket CORS（使用示例：bucket/putCORS.go）
• Put Bucket Lifecycle（使用示例：bucket/putLifecycle.go）
• Put Bucket Tagging（使用示例：bucket/putTagging.go）
• Put Bucket policy
• Delete Bucket（删除 bucket，使用示例：bucket/delete.go）
• Delete Bucket CORS（使用示例：bucket/deleteCORS.go）
• Delete Bucket Lifecycle（使用示例：bucket/deleteLifecycle.go）
• Delete Bucket Tagging（使用示例：bucket/deleteTagging.go）
• Delete Bucket policy
• Head Bucket（使用示例：bucket/head.go）
• List Multipart Uploads（查询上传的分块，使用示例：bucket/listMultipartUploads.go）

Object API:

• Append Object（增量更新文件，使用示例：object/append.go）
• Get Object（下载文件，使用示例：object/get.go）
• Get Object ACL（使用示例：object/getACL.go）
• Put Object（上传文件，使用示例：object/put.go or object/uploadFile.go）
• Put Object ACL（使用示例：object/putACL.go）
• Put Object Copy（使用示例：object/copy.go）
• Delete Object（删除文件，使用示例：object/delete.go）
• Post Object
• Post Object restore
• Delete Multiple Object（使用示例：object/deleteMultiple.go）
• Head Object（使用示例：object/head.go）
• Options Object（使用示例：object/options.go）
• Initiate Multipart Upload（初始化分块上传，使用示例：object/initiateMultipartUpload.go）
• Upload Part（上传一个分块，使用示例：object/uploadPart.go）
• Upload Part - Copy
• List Parts（列出已上传的分块，使用示例：object/listParts.go）
• Complete Multipart Upload（合并上传的分块，使用示例：object/completeMultipartUpload.go）
• Abort Multipart Upload（取消分块上传，使用示例：object/abortMultipartUpload.go）

其他功能：

• 生成预签名授权 URL
  • 通过预签名授权 URL 下载文件，示例：object/getWithPresignedURL.go
  • 通过预签名授权 URL 上传文件，示例：object/putWithPresignedURL.go
• 支持临时密钥，示例: object/sessionToken.go
• 支持使用使用第三方 http client 包或单元测试时 mock 方法调用结果，示例：object/mock.go