Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mozillazg/go-cos

腾讯云对象存储服务 COS(Cloud Object Storage) Go SDK（XML API）
https://github.com/mozillazg/go-cos

cos cos-sdk go golang qcloud qcloud-sdk sdk

Last synced: 22 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/mozillazg/go-cos
Owner: mozillazg
License: mit
Created: 2017-06-24T12:51:50.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2021-04-29T19:33:56.000Z (over 3 years ago)
Last Synced: 2024-11-17T12:13:06.021Z (about 2 months ago)
Topics: cos, cos-sdk, go, golang, qcloud, qcloud-sdk, sdk
Language: Go
Homepage: https://godoc.org/github.com/mozillazg/go-cos
Size: 269 KB
Stars: 88
Watchers: 9
Forks: 26
Open Issues: 5
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        # go-cos

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

[![Build Status](https://img.shields.io/travis/mozillazg/go-cos/master.svg)](https://travis-ci.org/mozillazg/go-cos)

[![Coverage Status](https://img.shields.io/codecov/c/github/mozillazg/go-cos/master.svg)](https://codecov.io/gh/mozillazg/go-cos)

[![Go Report Card](https://goreportcard.com/badge/github.com/mozillazg/go-cos)](https://goreportcard.com/report/github.com/mozillazg/go-cos)

[![GoDoc](https://godoc.org/github.com/mozillazg/go-cos?status.svg)](https://godoc.org/github.com/mozillazg/go-cos)

## Install

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

推荐使用 [go mod](https://github.com/golang/go/wiki/Modules) 之类的技术指定使用的 go-cos 包版本号。

## Usage

```go

package main

import (

	"context"

	"fmt"

	"io/ioutil"

	"net/http"

	"net/url"

	"os"

	"github.com/mozillazg/go-cos"

)

func main() {

	b, _ := cos.NewBaseURL("https://-.cos..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](./_example/) 目录下都有对应的使用示例（示例程序中用到的 `debug` 包只是调试用的不是必需的依赖）。

## TODO

Service API:

* [x] Get Service（使用示例：[service/get.go](./_example/service/get.go)）

Bucket API:

* [x] **Get Bucket**（搜索文件，使用示例：[bucket/get.go](./_example/bucket/get.go)）

* [x] Get Bucket ACL（使用示例：[bucket/getACL.go](./_example/bucket/getACL.go)）

* [x] Get Bucket CORS（使用示例：[bucket/getCORS.go](./_example/bucket/getCORS.go)）

* [x] Get Bucket Location（使用示例：[bucket/getLocation.go](./_example/bucket/getLocation.go)）

* [x] Get Buket Lifecycle（使用示例：[bucket/getLifecycle.go](./_example/bucket/getLifecycle.go)）

* [x] Get Bucket Tagging（使用示例：[bucket/getTagging.go](./_example/bucket/getTagging.go)）

* [ ] Get Bucket policy

* [x] Put Bucket（创建 bucket，使用示例：[bucket/put.go](./_example/bucket/put.go)）

* [x] Put Bucket ACL（使用示例：[bucket/putACL.go](./_example/bucket/putACL.go)）

* [x] Put Bucket CORS（使用示例：[bucket/putCORS.go](./_example/bucket/putCORS.go)）

* [x] Put Bucket Lifecycle（使用示例：[bucket/putLifecycle.go](./_example/bucket/putLifecycle.go)）

* [x] Put Bucket Tagging（使用示例：[bucket/putTagging.go](./_example/bucket/putTagging.go)）

* [ ] Put Bucket policy

* [x] Delete Bucket（删除 bucket，使用示例：[bucket/delete.go](./_example/bucket/delete.go)）

* [x] Delete Bucket CORS（使用示例：[bucket/deleteCORS.go](./_example/bucket/deleteCORS.go)）

* [x] Delete Bucket Lifecycle（使用示例：[bucket/deleteLifecycle.go](./_example/bucket/deleteLifecycle.go)）

* [x] Delete Bucket Tagging（使用示例：[bucket/deleteTagging.go](./_example/bucket/deleteTagging.go)）

* [ ] Delete Bucket policy

* [x] Head Bucket（使用示例：[bucket/head.go](./_example/bucket/head.go)）

* [x] List Multipart Uploads（查询上传的分块，使用示例：[bucket/listMultipartUploads.go](./_example/bucket/listMultipartUploads.go)）

Object API:

* [x] **Append Object**（增量更新文件，使用示例：[object/append.go](./_example/object/append.go)）

* [x] **Get Object**（下载文件，使用示例：[object/get.go](./_example/object/get.go)）

* [x] Get Object ACL（使用示例：[object/getACL.go](./_example/object/getACL.go)）

* [x] **Put Object**（上传文件，使用示例：[object/put.go](./_example/object/put.go) or [object/uploadFile.go](./_example/object/uploadFile.go)）

* [x] Put Object ACL（使用示例：[object/putACL.go](./_example/object/putACL.go)）

* [x] Put Object Copy（使用示例：[object/copy.go](./_example/object/copy.go)）

* [x] **Delete Object**（删除文件，使用示例：[object/delete.go](./_example/object/delete.go)）

* [ ] [Post Object](https://cloud.tencent.com/document/product/436/14690)

* [ ] [Post Object restore](https://cloud.tencent.com/document/product/436/12633)

* [x] Delete Multiple Object（使用示例：[object/deleteMultiple.go](./_example/object/deleteMultiple.go)）

* [x] Head Object（使用示例：[object/head.go](./_example/object/head.go)）

* [x] Options Object（使用示例：[object/options.go](./_example/object/options.go)）

* [x] **Initiate Multipart Upload**（初始化分块上传，使用示例：[object/initiateMultipartUpload.go](./_example/object/initiateMultipartUpload.go)）

* [x] **Upload Part**（上传一个分块，使用示例：[object/uploadPart.go](./_example/object/uploadPart.go)）

* [ ] [Upload Part - Copy](https://cloud.tencent.com/document/product/436/8287)

* [x] **List Parts**（列出已上传的分块，使用示例：[object/listParts.go](./_example/object/listParts.go)）

* [x] **Complete Multipart Upload**（合并上传的分块，使用示例：[object/completeMultipartUpload.go](./_example/object/completeMultipartUpload.go)）

* [x] **Abort Multipart Upload**（取消分块上传，使用示例：[object/abortMultipartUpload.go](./_example/object/abortMultipartUpload.go)）

其他功能：

* [x] **生成预签名授权 URL**

    * [x] 通过预签名授权 URL 下载文件，示例：[object/getWithPresignedURL.go](./_example/object/getWithPresignedURL.go)

    * [x] 通过预签名授权 URL 上传文件，示例：[object/putWithPresignedURL.go](./_example/object/putWithPresignedURL.go)

* [x] 支持临时密钥，示例: [object/sessionToken.go](./_example/object/sessionToken.go)

* [x] 支持使用使用第三方 http client 包或单元测试时 mock 方法调用结果，示例：[object/mock.go](./_example/object/mock.go)