简介

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

设置对象标签

功能说明

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

方法原型

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

请求示例

try {
 $result = $cosClient->putObjectTagging(array(
     'Bucket' => 'examplebucket-1250000000', //格式：BucketName-APPID
     '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());

请求示例

try {
  $result = $cosClient->getObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', //格式：BucketName-APPID
      '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());

请求示例

try {
  $result = $cosClient->deleteObjectTagging(array(
      'Bucket' => 'examplebucket-1250000000', //格式：BucketName-APPID
      'Key'    => 'exampleobject',
  );
  // 请求成功
  print_r($result);
} catch (\Exception $e) {
  // 请求失败
  echo($e);
}

参数说明