简介
本文档提供关于对象标签的 API 概览以及 SDK 示例代码。
设置对象标签
功能说明
PUT Object tagging 用于为对象设置标签。
方法原型
public Guzzle\Service\Resource\Model PutObjectTagging(array $args = array());
请求示例
<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID";
$secretKey = "SECRETKEY";
$region = "ap-beijing";
$cosClient = new Qcloud\Cos\Client(
array(
'region' => $region,
'schema' => 'https',
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));
try {
$result = $cosClient->putObjectTagging(array(
'Bucket' => 'examplebucket-1250000000',
'Key' => 'exampleobject',
'TagSet' => array(
array('Key'=>'key1',
'Value'=>'value1',
),
array('Key'=>'key2',
'Value'=>'value2',
),
),
));
print_r($result);
} catch (\Exception $e) {
echo "$e\n";
}
参数说明
参数名称 |
描述 |
类型 |
Bucket |
设置标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 |
String |
Key |
设置标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 |
String |
TagSet |
对象的标签配置集合 |
Array |
TagSet 成员说明:
参数名称 |
描述 |
类型 |
Key |
标签的 key |
String |
Value |
标签的 value |
String |
查询对象标签
功能说明
GET Object tagging 用于查询指定对象下已有的对象标签。
方法原型
public Guzzle\Service\Resource\Model GetObjectTagging(array $args = array());
请求示例
<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID";
$secretKey = "SECRETKEY";
$region = "ap-beijing";
$cosClient = new Qcloud\Cos\Client(
array(
'region' => $region,
'schema' => 'https',
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));
try {
$result = $cosClient->getObjectTagging(array(
'Bucket' => 'examplebucket-1250000000',
'Key' => 'exampleobject',
));
print_r($result);
} catch (\Exception $e) {
echo($e);
}
参数说明
参数名称 |
描述 |
类型 |
Bucket |
查询标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 |
String |
Key |
查询标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 |
String |
返回结果示例
GuzzleHttp\Command\Result Object
(
[TagSet] => Array
(
[0] => Array
(
[Key] => key1
[Value] => value1
)
[1] => Array
(
[Key] => key2
[Value] => value2
)
)
[RequestId] => NWRmMWVkMjFfMjJiMjU4NjRfNWQ3X2EwMWVj****
)
返回结果说明
成员变量 |
描述 |
类型 |
Key |
标签的键 |
String |
Value |
标签的值 |
String |
删除对象标签
功能说明
DELETE Object tagging 用于删除指定对象的已有标签。
方法原型
public Guzzle\Service\Resource\Model DeleteObjectTagging(array $args = array());
请求示例
<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID";
$secretKey = "SECRETKEY";
$region = "ap-beijing";
$cosClient = new Qcloud\Cos\Client(
array(
'region' => $region,
'schema' => 'https',
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));
try {
$result = $cosClient->deleteObjectTagging(array(
'Bucket' => 'examplebucket-1250000000',
'Key' => 'exampleobject',
);
print_r($result);
} catch (\Exception $e) {
echo($e);
}
参数说明
参数名称 |
描述 |
类型 |
Bucket |
删除标签的对象所在的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 |
String |
Key |
删除标签的对象键,对象键(Key)是对象在存储桶中的唯一标识,详情请参见 对象键 |
String |
本页内容是否解决了您的问题?