tencent cloud

Feedback

Extracting Buckets

Last updated: 2022-05-19 14:45:17

    Overview

    This document provides an overview of APIs and SDK code samples for checking a bucket.

    API Operation Description
    HEAD Bucket Checking a bucket and its permissions Checks whether a bucket exists and whether you have permission to access it

    Checking a Bucket and Its Permissions

    Feature description

    This API is used to check whether a bucket exists and whether you have permission to access it.

    Method prototype

    func (s *BucketService) Head(ctx context.Context) (*Response, error)
    

    Sample request

    package main
    import (
           "context"
           "github.com/tencentyun/cos-go-sdk-v5"
           "net/http"
           "net/url"
           "os"
    )
    func main() {
           // Bucket name in the format of `BucketName-APPID` (`APPID` is required), which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket.
           // Replace it with your `region`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/. For more information about regions, see 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{
                           // Get the key from environment variables
                           // Environment variable `SECRETID` refers to the user's `SecretId`, which can be viewed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi.
                           SecretID: os.Getenv("SECRETID"),
                           // Environment variable `SECRETKEY` refers to the user's `SecretKey`, which can be viewed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi.
                           SecretKey: os.Getenv("SECRETKEY"),
                   },
           })
            _, err := client.Bucket.Head(context.Background())
           if err != nil {
                   panic(err)
           }
    }
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support