tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for object tagging.

Tagging an Object

Feature description

This API (PUT Object tagging) is used to tag an object.

Method prototype

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

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.tencentcloud.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
 array(
     'region' => $region,
     'schema' => 'https', // Protocol header, which is http by default
     'credentials'=> array(
         'secretId'  => $secretId ,
         'secretKey' => $secretKey)));
try {
 $result = $cosClient->putObjectTagging(array(
     'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket
     'Key'    => 'exampleobject',
     'TagSet' => array(
         array('Key'=>'key1',
               'Value'=>'value1',
         ),  
         array('Key'=>'key2',
               'Value'=>'value2',
         ),  
     ),  
 ));
 // Request succeeded
 print_r($result);
} catch (\Exception $e) {
 // Request failed
 echo "$e\n";
}

Parameter description

Description of the TagSet member:

Querying Object Tags

Feature description

This API (GET Object tagging) is used to query the existing tags of an object.

Method prototype

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

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.tencentcloud.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is http by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->getObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket
      'Key'    => 'exampleobject',
  ));
  // Request succeeded
  print_r($result);
} catch (\Exception $e) {
  // Request failed
  echo($e);
}

Parameter description

Sample response

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

Response description

Deleting Object Tags

Feature description

This API (DELETE Object tagging) is used to delete the existing tags of an object.

Method prototype

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

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.tencentcloud.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is http by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
          
try {
  $result = $cosClient->deleteObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket
      'Key'    => 'exampleobject',
  );
  // Request succeeded
  print_r($result);
} catch (\Exception $e) {
  // Request failed
  echo($e);
}

Parameter description