tencent cloud

文档反馈

图片样式

最后更新时间:2022-01-04 12:30:50

    简介

    本文档提供关于图片样式相关的 API 概览以及 SDK 示例代码。

    API 说明
    增加样式 增加存储桶样式
    查询样式 查询存储桶样式
    删除样式 删除存储桶样式

    增加样式

    功能说明

    对某一个存储桶设置样式功能,后续上传到该存储桶的图片文件都会被添加指定的样式。

    示例代码

    <?php
    require dirname(__FILE__) . '/../vendor/autoload.php';
    $secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.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->PutBucketImageStyle(array(
          'Bucket' => 'examplebucket-1250000000', //存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
          'StyleName' => 'style_name',//样式名称
          'StyleBody' => 'imageMogr2/thumbnail/!50px', //样式信息
      ));
      // 请求成功
      print_r($result);
    } catch (\Exception $e) {
      // 请求失败
      echo($e);
    }
    

    参数说明

    参数名称 类型 描述 是否必填
    Bucket String 存储桶名称,格式:BucketName-APPID
    StyleName String 样式名称
    StyleBody String 样式信息

    返回结果示例

    Guzzle\Service\Resource\Model Object
    (
      [structure:protected] => 
      [data:protected] => Array
          (
              [RequestId] => NWQwOGRkNDdfMjJiMjU4NjRfNzVjXzEwNmVjY2M=
              [Bucket] => examplebucket-1250000000
              [Location] => examplebucket-1250000000.pic.ap-beijing.myqcloud.com/
          )
    )
    

    返回结果说明

    参数名称 类型 描述 父节点
    RequestId String 请求 ID 标识
    Bucket String 存储桶名称,格式:BucketName-APPID
    Location String 请求资源地址

    查询样式

    功能说明

    查询某个存储桶下已有的样式。

    示例代码

    <?php
    require dirname(__FILE__) . '/../vendor/autoload.php';
    $secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.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->GetBucketImageStyle(array(
           'Bucket' => 'examplebucket-1250000000', //存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
           'StyleName' => 'style_name', //样式名称
       ));
       // 请求成功
       print_r($result);
    } catch (\Exception $e) {
       // 请求失败
       echo($e);
    }
    

    参数说明

    参数名称 类型 描述 是否必填
    Bucket String 存储桶名称,格式:BucketName-APPID
    StyleName String 样式名称

    返回结果示例

    Guzzle\Service\Resource\Model Object
    (
      [structure:protected] => 
      [data:protected] => Array
          (
              [RequestId] => NWQwOGRkNDdfMjJiMjU4NjRfNzVjXzEwNmVjY2M=
              [Bucket] => examplebucket-1250000000
              [Location] => examplebucket-1250000000.pic.ap-beijing.myqcloud.com/
              [StyleRule] => Array(
                  [0] => Array(
                      [StyleName] => style_name
                      [StyleBody] => imageMogr2/thumbnail/!50px
                  )
              )
         )
    )
    

    返回结果说明

    参数名称 类型 描述 父节点
    RequestId String 请求 ID 标识
    Bucket String 存储桶名称,格式:BucketName-APPID
    Location String 请求资源地址
    StyleRule Array 样式信息列表

    删除样式

    功能说明

    删除某一特定样式。

    示例代码

    <?php
    require dirname(__FILE__) . '/../vendor/autoload.php';
    $secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
    $region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.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->DeleteBucketImageStyle(array(
           'Bucket' => 'examplebucket-1250000000', //存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
           'StyleName' => 'style_name', //样式名称
       ));
       // 请求成功
       print_r($result);
    } catch (\Exception $e) {
       // 请求失败
       echo($e);
    }
    

    参数说明

    参数名称 类型 描述 是否必填
    Bucket String 存储桶名称,格式:BucketName-APPID
    StyleName String 样式名称

    返回结果示例

    Guzzle\Service\Resource\Model Object
    (
      [structure:protected] => 
      [data:protected] => Array
          (
              [RequestId] => NWQwOGRkNDdfMjJiMjU4NjRfNzVjXzEwNmVjY2M=
              [Bucket] => examplebucket-1250000000
              [Location] => examplebucket-1250000000.pic.ap-beijing.myqcloud.com/
         )
    )
    

    返回结果说明

    参数名称 类型 描述 父节点
    RequestId String 请求 ID 标识
    Bucket String 存储桶名称,格式:BucketName-APPID
    Location String 请求资源地址
    联系我们

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

    技术支持

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

    7x24 电话支持