This document provides an overview of APIs and SDK code samples related to bucket tagging.
API | Operation | Description |
---|---|---|
PUT Bucket tagging | Setting bucket tags | Sets tags for an existing bucket |
GET Bucket tagging | Querying bucket tags | Queries the existing tags of a bucket |
DELETE Bucket tagging | Deleting bucket tags | Deletes a specified bucket tag |
This API (PUT Bucket tagging) is used to set tags for an existing bucket.
CosResult PutBucketTagging(const PutBucketTaggingReq& request, PutBucketTaggingResp* response);
qcloud_cos::CosConfig config("./config.json");
qcloud_cos::CosAPI cos(config);
std::string bucket_name = "examplebucket-1250000000";
qcloud_cos::PutBucketTaggingReq req(bucket_name);
qcloud_cos::PutBucketTaggingResp resp;
std::vector<Tag> tagset;
Tag tag1;
tag1.SetKey("age");
tag1.SetValue("19");
Tag tag2;
tag2.SetKey("name");
tag2.SetValue("xiaoming");
tagset.push_back(tag1);
tagset.push_back(tag2);
req.SetTagSet(tagset);
qcloud_cos::CosResult result = cos.PutBucketTagging(req, &resp);
if (result.IsSucc()) {
// Request successful
} else {
// Request failed. You can call the CosResult member functions to output the error information, such as requestID.
}
Parameter | Description | Type | Required |
---|---|---|---|
req | Request of the PutBucketTagging operation |
PutBucketTaggingReq | Yes |
resp | Response of the PutBucketTagging operation |
PutBucketTaggingResp | Yes |
PutBucketTaggingReq
provides the following method:
void SetTagSet(std::vector<Tag>& tagset) // Set tagging.
Tag
provides the following methods:
class Tag {
void SetKey(const std::string key); // Set the key.
void SetValue(const std::string value); // Set the value.
This API (GET Bucket tagging) is used to query the existing tags of a bucket.
CosResult CosAPI::GetBucketTagging(const GetBucketTaggingReq& request, GetBucketTaggingResp* response);
qcloud_cos::CosConfig config("./config.json");
qcloud_cos::CosAPI cos(config);
std::string bucket_name = "examplebucket-1250000000";
qcloud_cos::GetBucketTaggingReq req(bucket_name);
qcloud_cos::GetBucketTaggingResp resp;
qcloud_cos::CosResult result = cos.GetBucketTagging(req, &resp);
if (result.IsSucc()) {
// Request successful. You can use the method of `resp` to obtain the bucket tags.
} else {
// Request failed. You can call the CosResult member functions to output the error information, such as requestID.
}
GetBucketTaggingResp
provides the following method to obtain the bucket tags:
std::vector<Tag> GetTagSet() const;
Parameter | Description | Type | Required |
---|---|---|---|
req | Request of the GetBucketTagging operation |
GetBucketTaggingReq | Yes |
resp | Response of the GetBucketTagging operation |
GetBucketTaggingResp | Yes |
This API (DELETE Bucket tagging) is used to delete the existing tags of a bucket.
CosResult CosAPI::DeleteBucketTagging(const DeleteBucketTaggingReq& request, DeleteBucketTaggingResp* response);
qcloud_cos::CosConfig config("./config.json");
qcloud_cos::CosAPI cos(config);
std::string bucket_name = "examplebucket-1250000000";
qcloud_cos::DeleteBucketTaggingReq req(bucket_name);
qcloud_cos::DeleteBucketTaggingResp resp;
qcloud_cos::CosResult result = cos.DeleteBucketTagging(req, &resp);
if (result.IsSucc()) {
// Request successful
} else {
// Request failed. You can call the CosResult member functions to output the error information, such as requestID.
}
Parameter | Description | Type | Required |
---|---|---|---|
req | Request of the DeleteBucketTagging operation |
DeleteBucketTaggingReq | Yes |
resp | Response of the DeleteBucketTagging operation |
DeleteBucketTaggingResp | Yes |
Was this page helpful?