go-cos

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

Install

go get -u github.com/mozillazg/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)
	}
	bs, _ := ioutil.ReadAll(resp.Body)
	resp.Body.Close()
	fmt.Printf("%s\n", string(bs))
}

所有的 API 在 _example 目录下都有对应的使用示例。

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）
• 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）
• Delete Bucket（删除 bucket，使用示例：bucket/delete.go）
• Delete Bucket CORS（使用示例：bucket/deleteCORS.go）
• Delete Bucket Lifecycle（使用示例：bucket/deleteLifecycle.go）
• Delete Bucket Tagging（使用示例：bucket/deleteTagging.go）
• 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）
• Put Object ACL（使用示例：object/putACL.go）
• Put Object Copy（使用示例：object/copy.go）
• Delete Object（删除文件，使用示例：object/delete.go）
• 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）
• 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