使用Golang调用腾讯云对象存储(COS)


本文档介绍如何使用Golang调用腾讯云对象存储(COS),包括初始化客户端、上传文件和下载文件。

一、腾讯云COS对象存储创建

1.1 创建存储桶

  1. 我们需要创建一个用于存放对象的存储桶:

  2. 在 对象存储控制台 左侧导航栏中单击存储桶列表,进入存储桶管理页。

  3. 单击创建存储桶,输入以下配置信息,其他配置保持默认即可。

名称:输入存储桶名称。名称设置后不可修改。此处举例输入 exampleobjext 。

所属地域:存储桶所属地域,选择与您业务最近的一个地区,例如香港地域。

访问权限:存储桶访问权限,此处我们保持默认为“私有读写”。

单击确定,即可创建完成。

2.1 存储桶测试

  • 上传对象

从本地选择文件上传到存储桶:

  1. 单击存储桶名称,进入存储桶列表页。

  2. 选择上传文件 > 选择文件,选择需要上传至存储桶的文件,例如文件名为 exampleobjext.txt 的文件。

  3. 单击上传,即可将文件 exampleobjext.txt 上传至存储桶。

  • 下载对象

将云上数据下载到本地:

1.单击文件 exampleobjext.txt 右侧的详情,进入对象属性页。

2.在基本信息配置项中,单击下载对象即可下载,或单击复制临时链接,将链接粘贴至浏览器地址栏并回车,即可下载该对象。

  • 删除对象

将云上对象数据删除:

  1. 在左侧导航栏中,单击【存储桶列表】,进入存储桶列表页面。

  2. 找到对象所在的存储桶,单击其存储桶名称,进入存储桶管理页面。

  3. 在左侧导航栏中,选择【文件列表】,进入文件列表页面。

  4. 勾选需要删除的对象,单击上方的【更多操作】>【删除】。

二、使用Golang调用腾讯云对象存储(COS)

2.1 安装COS SDK

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

2.2 初始化COS客户端

package main

import (
    "context"
    "fmt"
    "github.com/tencentyun/cos-go-sdk-v5"
    "net/http"
    "net/url"
)

func initCOSClient(bucketName, region, secretID, secretKey string) *cos.Client {
    u, _ := url.Parse(fmt.Sprintf("https://%s.cos.%s.myqcloud.com", bucketName, region))
    b := &cos.BaseURL{BucketURL: u}

    return cos.NewClient(b, &http.Client{
        Transport: &cos.AuthorizationTransport{
            SecretID:  secretID,
            SecretKey: secretKey,
        },
    })
}

func main() {
    client := initCOSClient("<your-bucket-name>", "<region>", "<your-secret-id>", "<your-secret-key>")
    fmt.Println("COS client initialized successfully.")
}

2.3 上传文件

下面的函数用于将本地文件上传到COS。

  • 上传文件方法
func uploadFile(client *cos.Client, localFilePath, remoteFilePath string) error {
    fmt.Printf("Uploading file from %s to %s\n", localFilePath, remoteFilePath)

    f, err := os.Open(localFilePath)
    if err != nil {
        return fmt.Errorf("opening file: %v", err)
    }
    defer f.Close()

    _, err = client.Object.Put(context.Background(), remoteFilePath, f, nil)
    if err != nil {
        return fmt.Errorf("uploading file: %v", err)
    }
    return nil
}
  • 方法调用示例
func main() {
    client := initCOSClient("<your-bucket-name>", "<region>", "<your-secret-id>", "<your-secret-key>")

    localUploadPath := "local/path/to/example.txt"
    remoteUploadPath := "remote/path/to/example.txt"
    err := uploadFile(client, localUploadPath, remoteUploadPath)
    if err != nil {
        fmt.Println("Error uploading file:", err)
    } else {
        fmt.Println("File uploaded successfully.")
    }
}

2.4 下载文件

下面的函数用于从COS下载文件并保存到本地。

  • 下载文件方法
func downloadFile(client *cos.Client, remoteFilePath, localFilePath string) error {
    fmt.Printf("Downloading file from %s to %s\n", remoteFilePath, localFilePath)

    // 确保目录存在
    dir := filepath.Dir(localFilePath)
    if err := os.MkdirAll(dir, 0755); err != nil {
        return fmt.Errorf("creating directories: %v", err)
    }

    resp, err := client.Object.Get(context.Background(), remoteFilePath, nil)
    if err != nil {
        return fmt.Errorf("downloading file: %v", err)
    }
    defer resp.Body.Close()

    localFile, err := os.Create(localFilePath)
    if err != nil {
        return fmt.Errorf("creating file: %v", err)
    }
    defer localFile.Close()

    _, err = localFile.ReadFrom(resp.Body)
    if err != nil {
        return fmt.Errorf("writing to file: %v", err)
    }
    return nil
}
  • 方法调用示例
func main() {
    client := initCOSClient("<your-bucket-name>", "<region>", "<your-secret-id>", "<your-secret-key>")

    localDownloadPath := "local/path/to/downloaded_example.txt"
    remoteDownloadPath := "remote/path/to/example.txt"
    err := downloadFile(client, remoteDownloadPath, localDownloadPath)
    if err != nil {
        fmt.Println("Error downloading file:", err)
    } else {
        fmt.Println("File downloaded successfully.")
    }
}

2.5 列出存储桶中的对象

有时候我们可能需要列出存储桶中的对象以确认文件是否存在。

func listObjects(client *cos.Client, prefix string) error {
    opt := &cos.BucketGetOptions{
        Prefix: prefix,
    }
    v, _, err := client.Bucket.Get(context.Background(), opt)
    if err != nil {
        return fmt.Errorf("listing objects: %v", err)
    }

    for _, c := range v.Contents {
        fmt.Println(c.Key)
    }
    return nil
}

func main() {
    client := initCOSClient("<your-bucket-name>", "<region>", "<your-secret-id>", "<your-secret-key>")

    // 列出存储桶中的对象
    err := listObjects(client, "remote/path/to/")
    if err != nil {
        fmt.Println("Error listing objects:", err)
    }
}

2.6 整体代码示例

package main

import (
	"context"
	"fmt"
	"github.com/tencentyun/cos-go-sdk-v5"
	"net/http"
	"net/url"
	"os"
	"path/filepath"
)

func main() {
	// 初始化COS客户端
    client := initCOSClient("<your-bucket-name>", "<region>", "<your-secret-id>", "<your-secret-key>")
	// 上传文件
	localUploadPath := "local/path/to/example.txt"
	remoteUploadPath := "remote/path/to/example.txt"
	err := uploadFile(client, localUploadPath, remoteUploadPath)
	if err != nil {
		fmt.Println("Error uploading file:", err)
	} else {
		fmt.Println("File uploaded successfully.")
	}

	// 下载文件
	localDownloadPath := "local/path/to/downloaded_example.txt"
	remoteDownloadPath := "remote/path/to/example.txt"
	err = downloadFile(client, remoteDownloadPath, localDownloadPath)
	if err != nil {
		fmt.Println("Error downloading file:", err)
	} else {
		fmt.Println("File downloaded successfully.")
	}

	// 列出存储桶中的对象
	err = listObjects(client, "remote/path/to/")
	if err != nil {
		fmt.Println("Error listing objects:", err)
	}
}

// 初始化COS客户端
func initCOSClient(bucketName, region, secretID, secretKey string) *cos.Client {
	u, _ := url.Parse(fmt.Sprintf("https://%s.cos.%s.myqcloud.com", bucketName, region))
	b := &cos.BaseURL{BucketURL: u}

	return cos.NewClient(b, &http.Client{
		Transport: &cos.AuthorizationTransport{
			SecretID:  secretID,
			SecretKey: secretKey,
		},
	})
}

// 上传文件
func uploadFile(client *cos.Client, localFilePath, remoteFilePath string) error {
	fmt.Printf("Uploading file from %s to %s\n", localFilePath, remoteFilePath)

	f, err := os.Open(localFilePath)
	if err != nil {
		return fmt.Errorf("opening file: %v", err)
	}
	defer f.Close()

	_, err = client.Object.Put(context.Background(), remoteFilePath, f, nil)
	if err != nil {
		return fmt.Errorf("uploading file: %v", err)
	}
	return nil
}

// 下载文件
func downloadFile(client *cos.Client, remoteFilePath, localFilePath string) error {
	fmt.Printf("Downloading file from %s to %s\n", remoteFilePath, localFilePath)

	// 确保目录存在
	dir := filepath.Dir(localFilePath)
	if err := os.MkdirAll(dir, 0755); err != nil {
		return fmt.Errorf("creating directories: %v", err)
	}

	resp, err := client.Object.Get(context.Background(), remoteFilePath, nil)
	if err != nil {
		return fmt.Errorf("downloading file: %v", err)
	}
	defer resp.Body.Close()

	localFile, err := os.Create(localFilePath)
	if err != nil {
		return fmt.Errorf("creating file: %v", err)
	}
	defer localFile.Close()

	_, err = localFile.ReadFrom(resp.Body)
	if err != nil {
		return fmt.Errorf("writing to file: %v", err)
	}
	return nil
}

// 列出存储桶中的对象
func listObjects(client *cos.Client, prefix string) error {
	opt := &cos.BucketGetOptions{
		Prefix: prefix,
	}
	v, _, err := client.Bucket.Get(context.Background(), opt)
	if err != nil {
		return fmt.Errorf("listing objects: %v", err)
	}

	for _, c := range v.Contents {
		fmt.Println(c.Key)
	}
	return nil
}

参考文档:

  • 腾讯云对象存储创建文档:https://cloud.tencent.com/document/product/436/14106
  • 腾讯云对象存储golang-SDK:https://cloud.tencent.com/document/product/436/31215
  • 腾讯云对象存储常见问题:https://cloud.tencent.com/document/product/436/30748
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

杰哥的技术杂货铺

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值