简介

本文档提供关于对象标签的 API 概览以及 SDK 示例代码。

设置对象标签

功能说明

PUT Object tagging 用于为对象设置标签。

方法原型

public Guzzle\Service\Resource\Model PutObjectTagging(array $args = 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->putObjectTagging(array(
     'Bucket' => 'examplebucket-1250000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
     'Key'    => 'exampleobject',
     'TagSet' => array(
         array('Key'=>'key1',
               'Value'=>'value1',
         ),  
         array('Key'=>'key2',
               'Value'=>'value2',
         ),  
     ),  
 ));
 // 请求成功
 print_r($result);
} catch (\Exception $e) {
 // 请求失败
 echo "$e\n";
}

参数说明

TagSet 成员说明：

查询对象标签

功能说明

GET Object tagging 用于查询指定对象下已有的对象标签。

方法原型

public Guzzle\Service\Resource\Model GetObjectTagging(array $args = 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->getObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
      'Key'    => 'exampleobject',
  ));
  // 请求成功
  print_r($result);
} catch (\Exception $e) {
  // 请求失败
  echo($e);
}

参数说明

返回结果示例

GuzzleHttp\Command\Result Object
(
  [TagSet] => Array
      (
          [0] => Array
              (
                  [Key] => key1
                  [Value] => value1
              )
           [1] => Array
              (
                  [Key] => key2
                  [Value] => value2
              )
       )
  [RequestId] => NWRmMWVkMjFfMjJiMjU4NjRfNWQ3X2EwMWVj****
)

返回结果说明

删除对象标签

功能说明

DELETE Object tagging 用于删除指定对象的已有标签。

方法原型

public Guzzle\Service\Resource\Model DeleteObjectTagging(array $args = 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->deleteObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
      'Key'    => 'exampleobject',
  );
  // 请求成功
  print_r($result);
} catch (\Exception $e) {
  // 请求失败
  echo($e);
}

参数说明