tencent cloud

文档反馈

存储桶标签

最后更新时间:2024-01-04 18:00:58

    简介

    本文档提供关于存储桶标签的 API 概览以及 SDK 示例代码。
    API
    操作名
    操作描述
    设置存储桶标签
    为已存在的存储桶设置标签
    查询存储桶标签
    查询指定存储桶下已有的存储桶标签
    删除存储桶标签
    删除指定的存储桶标签

    设置存储桶标签

    功能说明

    PUT Bucket tagging 用于为已存在的存储桶设置标签。

    方法原型

    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()) {
    // 请求成功
    } else {
    // 请求失败,可以调用 CosResult 的成员函数输出错误信息,例如 requestID 等
    }

    参数说明

    参数
    参数描述
    类型
    是否必填
    req
    PutBucketTagging 操作的请求
    PutBucketTaggingReq
    resp
    PutBucketTagging 操作的响应
    PutBucketTaggingResp
    PutBucketTaggingReq 提供以下方法:
    void SetTagSet(std::vector<Tag>& tagset) // 设置 tagging
    Tag 提供以下方法:
    class Tag {
    void SetKey(const std::string key); // 设置 key
    void SetValue(const std::string value); // 设置 value

    查询存储桶标签

    功能说明

    GET Bucket tagging 用于查询指定存储桶下已有的存储桶标签。

    方法原型

    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()) {
    // 请求成功,通过 resp 的方法获取 Tagging
    } else {
    // 请求失败,可以调用 CosResult 的成员函数输出错误信息,例如 requestID 等
    }
    GetBucketTaggingResp 提供以下方法获取 Tagging
    std::vector<Tag> GetTagSet() const;

    参数说明

    参数
    参数描述
    类型
    是否必填
    req
    GetBucketTagging 操作的请求
    GetBucketTaggingReq
    resp
    GetBucketTagging 操作的响应
    GetBucketTaggingResp

    删除存储桶标签

    功能说明

    DELETE Bucket tagging 用于删除指定存储桶下已有的存储桶标签。

    方法原型

    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()) {
    // 请求成功
    } else {
    // 请求失败,可以调用 CosResult 的成员函数输出错误信息,例如 requestID 等
    }

    参数说明

    参数
    参数描述
    类型
    是否必填
    req
    DeleteBucketTagging 操作的请求
    DeleteBucketTaggingReq
    resp
    DeleteBucketTagging 操作的响应
    DeleteBucketTaggingResp
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持