tencent cloud

Feedback

Bucket Extraction

Last updated: 2021-11-25 12:52:18

    Overview

    This document provides an overview of APIs and SDK code samples related to bucket extraction.

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

    SDK API References

    For the parameters and method description of all the APIs in the SDK, see API Documentation.

    Checking a Bucket and Its Permissions

    Description

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

    • If the bucket exists and you have permission to read it, HTTP status code 200 will be returned.
    • If you do not have permission to read the bucket, HTTP status code 403 will be returned.
    • If the bucket does not exist, HTTP status code 404 will be returned.

    Sample code

    using COSXML.Model.Bucket;
    using COSXML.Auth;
    using System;
    using COSXML;
    namespace COSSnippet
    {
       public class HeadBucketModel {
          private CosXml cosXml;
          HeadBucketModel() {
           CosXmlConfig config = new CosXmlConfig.Builder()
             .SetRegion("COS_REGION") // Set the default region. For abbreviations of COS regions, visit https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1. 
             .Build();
    
           string secretId = "SECRET_ID";   // SecretId of the TencentCloud API. For more information about how to obtain the API key, see https://console.tencentcloud.com/cam/capi.
           string secretKey = "SECRET_KEY"; // SecretKey of the TencentCloud API. For more information about how to obtain the API key, see https://console.tencentcloud.com/cam/capi.
           long durationSecond = 600;          // Validity period of the request signature in seconds
           QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, 
             secretKey, durationSecond);
    
           this.cosXml = new CosXmlServer(config, qCloudCredentialProvider);
         }
          /// Query the bucket information.
         public void HeadBucket()
         {
           //.cssg-snippet-body-start:[head-bucket]
           try
           {
             // Bucket name in the format of BucketName-APPID. You can get APPID by referring to https://console.tencentcloud.com/developer.
             string bucket = "examplebucket-1250000000";
             HeadBucketRequest request = new HeadBucketRequest(bucket);
             // Execute the request
             HeadBucketResult result = cosXml.HeadBucket(request);
             // Request succeeded
             Console.WriteLine(result.GetResultInfo());
           }
           catch (COSXML.CosException.CosClientException clientEx)
           {
             // Request failed
             Console.WriteLine("CosClientException: " + clientEx);
           }
           catch (COSXML.CosException.CosServerException serverEx)
           {
             // Request failed
             Console.WriteLine("CosServerException: " + serverEx.GetInfo());
           }
    
           //.cssg-snippet-body-end
         }
         // .cssg-methods-pragma
          static void Main(string[] args)
         {
           HeadBucketModel m = new HeadBucketModel();
            /// Query the bucket information.
           m.HeadBucket();
           // .cssg-methods-pragma
         }
       }
    }
    
    Note:

    For the complete sample, go to GitHub.

    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