tencent cloud

简介

本文档提供关于创建存储桶的 API 概览以及 SDK 示例代码。

创建存储桶

功能说明

在指定账号下创建一个存储桶。同一用户账号下，可以创建多个存储桶，数量上限是200个（不区分地域），存储桶中的对象数量没有限制。创建存储桶是低频操作，一般建议在控制台创建 Bucket，在 SDK 进行 Object 的操作。

方法原型

func (s *BucketService) Put(ctx context.Context, opt *BucketPutOptions) (*Response, error)

请求示例

package main
import (
       "context"
       "github.com/tencentyun/cos-go-sdk-v5"
       "net/http"
       "net/url"
       "os"
)
func main() {
       // 存储桶名称，由bucketname-appid 组成，appid必须填入，可以在COS控制台查看存储桶名称。 https://console.intl.cloud.tencent.com/cos5/bucket
       // 替换为用户的 region，存储桶region可以在COS控制台“存储桶概览”查看 https://console.intl.cloud.tencent.com/ ，关于地域的详情见 https://intl.cloud.tencent.com/document/product/436/6224 。
       u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")
       b := &cos.BaseURL{BucketURL: u}
       client := cos.NewClient(b, &http.Client{
               Transport: &cos.AuthorizationTransport{
                       // 通过环境变量获取密钥
                       // 环境变量 SECRETID 表示用户的 SecretId，登录访问管理控制台查看密钥，https://console.intl.cloud.tencent.com/cam/capi
                       SecretID: os.Getenv("SECRETID"),
                       // 环境变量 SECRETKEY 表示用户的 SecretKey，登录访问管理控制台查看密钥，https://console.intl.cloud.tencent.com/cam/capi
                       SecretKey: os.Getenv("SECRETKEY"),
               },
       })
        // case1：创建存储桶
       opt := &cos.BucketPutOptions{
               XCosACL: "private",
       }
       _, err := client.Bucket.Put(context.Background(), opt)
       if err != nil {
               panic(err)
       }
}

参数说明

type BucketPutOptions struct {
XCosACL              string 
XCosGrantRead        string  
XCosGrantWrite       string  
XCosGrantFullControl string 
   CreateBucketConfiguration *CreateBucketConfiguration
}
type CreateBucketConfiguration struct {
   BucketAZConfig string
}