tencent cloud

文档反馈

判断存储桶是否存在

最后更新时间:2022-01-17 12:50:00

    简介

    本文档提供关于检查存储桶是否存在的 API 概览以及 SDK 示例代码。

    API 操作名 操作描述
    HEAD Bucket 检索存储桶及其权限 检索存储桶是否存在且是否有权限访问

    SDK API 参考

    SDK 所有接口的具体参数与方法说明,请参考 SDK API

    检查存储桶是否存在

    功能说明

    DoesBucketExist 请求可以确认该存储桶是否存在。

    说明:

    • DoesBucketExist 是 .NET SDK 提供的一种简化的 HEAD Bucket 接口,仅用于检查存储桶是否存在,并返回布尔类型。
    • 如需进一步获取存储桶详情,请使用 检索存储桶 接口。

    示例代码

    using COSXML.Model.Bucket;
    using COSXML.Auth;
    using System;
    using COSXML;
    namespace COSSnippet
    {
       public class DoesBucketExistModel {
          private CosXml cosXml;
          DoesBucketExistModel() {
           CosXmlConfig config = new CosXmlConfig.Builder()
             .SetRegion("COS_REGION") // 设置默认的地域, COS 地域的简称请参照 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 
             .Build();
    
           string secretId = "SECRET_ID";   // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
           string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
           long durationSecond = 600;          //每次请求签名有效时长,单位为秒
           QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, 
             secretKey, durationSecond);
    
           this.cosXml = new CosXmlServer(config, qCloudCredentialProvider);
         }
          /// 检查存储桶是否存在
         public void DoesBucketExist()
         {
           try
           {
             // 存储桶名称,此处填入格式必须为 BucketName-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
             string bucket = "examplebucket-1250000000";
             DoesBucketExistRequest request = new DoesBucketExistRequest(bucket);
             //执行请求
             bool existState = cosXml.DoesBucketExist(request);
             //请求成功
             Console.WriteLine("bucket exist state is: " + existState);
           }
           catch (COSXML.CosException.CosClientException clientEx)
           {
             //请求失败
             Console.WriteLine("CosClientException: " + clientEx);
           }
           catch (COSXML.CosException.CosServerException serverEx)
           {
             //请求失败
             Console.WriteLine("CosServerException: " + serverEx.GetInfo());
           }
    
         }
          static void Main(string[] args)
         {
           DoesBucketExistModel m = new DoesBucketExistModel();
            /// 检查存储桶是否存在
           m.DoesBucketExist();
         }
       }
    }
    
    说明:

    更多完整示例,请前往 GitHub 查看。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持