tencent cloud

文档反馈

检索存储桶

最后更新时间:2022-05-19 14:33:07

    简介

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

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

    检索存储桶及其权限

    功能说明

    HEAD Bucket 请求可以确认该存储桶是否存在,是否有权限访问。有以下几种情况:

    • 存储桶存在且有读取权限,返回 HTTP 状态码为200。
    • 无存储桶读取权限,返回 HTTP 状态码为403。
    • 存储桶不存在,返回 HTTP 状态码为404。

    方法原型

    public Guzzle\Service\Resource\Model headBucket(array $args = array());
    

    请求示例

    <?php
    require dirname(__FILE__) . '/../vendor/autoload.php';
    $secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.intl.cloud.tencent.com/cam/capi
    $secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.intl.cloud.tencent.com/cam/capi
    $region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.intl.cloud.tencent.com/cos5/bucket
    $cosClient = new Qcloud\Cos\Client(
      array(
          'region' => $region,
          'schema' => 'https', //协议头部,默认为http
          'credentials'=> array(
              'secretId'  => $secretId ,
              'secretKey' => $secretKey)));
    try {
      $result = $cosClient->headBucket(array(
          'Bucket' => 'examplebucket-125000000' //存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.intl.cloud.tencent.com/cos5/bucket
      ));
      // 请求成功
      print_r($result);
    } catch (\Exception $e) {
       // 请求失败
      echo($e);
    }
    

    参数说明

    参数名称 父节点 描述 类型
    Bucket 存储桶名称,格式:BucketName-APPID String
    联系我们

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

    技术支持

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

    7x24 电话支持