本文档提供关于存储桶标签的 API 概览以及 SDK 示例代码。
设置存储桶标签
功能说明
PUT Bucket tagging 用于为已存在的存储桶设置标签。
方法原型
public Guzzle\Service\Resource\Model PutBucketTagging(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->putBucketTagging(array(
'Bucket' => 'examplebucket-1250000000',
'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 |
标签的键 |
String |
Value |
标签的值 |
String |
查询存储桶标签
功能说明
GET Bucket tagging 用于查询指定存储桶下已有的存储桶标签。
方法原型
public Guzzle\Service\Resource\Model GetBucketTagging(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->getBucketTagging(array(
'Bucket' => 'examplebucket-1250000000',
));
print_r($result);
} catch (\Exception $e) {
echo($e);
}
参数说明
参数名称 |
描述 |
类型 |
Bucket |
查询标签的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 |
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 Bucket tagging 用于删除指定存储桶下已有的存储桶标签。
方法原型
public Guzzle\Service\Resource\Model DeleteBucketTagging(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->deleteBucketTagging(array(
'Bucket' => 'examplebucket-1250000000',
);
print_r($result);
} catch (\Exception $e) {
echo($e);
}
参数说明
参数名称 |
描述 |
类型 |
Bucket |
被删除标签的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 |
String |