腾讯云对象存储对象标签

简介

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

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参考 SDK API。

设置对象标签

功能说明

COS 支持为已存在的对象设置标签。通过为对象添加键值对作为对象标签，可以协助您分组管理已有的对象资源。

示例代码

Objective-C


    QCloudPutObjectTaggingRequest *putReq = [QCloudPutObjectTaggingRequest new];
    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    putReq.bucket = @"examplebucket-1250000000";
    // 标签集合    QCloudTagging *taggings = [QCloudTagging new];
    QCloudTag *tag1 = [QCloudTag new];
    // 标签的 Key，长度不超过128字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、    // 冒号、斜线    tag1.key = @"age";
    // 标签的 Value，长度不超过256字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号    // 、冒号、斜线    tag1.value = @"20";    QCloudTag *tag2 = [QCloudTag new];    tag2.key = @"name";    tag2.value = @"karis";
    // 标签集合，最多支持10个标签    QCloudTagSet *tagSet = [QCloudTagSet new];    tagSet.tag = @[tag1,tag2];    taggings.tagSet = tagSet;
    // 标签集合    putReq.taggings = taggings;
    [putReq setFinishBlock:^(id outputObject, NSError *error) {        // outputObject 包含所有的响应 http 头部        NSDictionary* info = (NSDictionary *) outputObject;    }];    [[QCloudCOSXMLService defaultCOSXML] PutObjectTagging:putReq];

Swift

    let putReq = QCloudPutObjectTaggingRequest()
    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    putReq.bucket = "examplebucket-1250000000";
    // 标签集合    let taggings = QCloudTagging();
    let tag1 = QCloudTag();
    // 标签的 Key，长度不超过128字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、    // 冒号、斜线    tag1.key = "age";
    // 标签的 Value，长度不超过256字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号    // 、冒号、斜线    tag1.value = "20";    let tag2 = QCloudTag();    tag2.key = "name";    tag2.value = "karis";
    // 标签集合，最多支持10个标签    let tagSet = QCloudTagSet();    tagSet.tag = [tag1,tag2];    taggings.tagSet = tagSet;
    // 标签集合    putReq.taggings = taggings;
    req.finishBlock = {(result,error) in        if let result = result {            // result 包含响应的 header 信息        } else {            print(error!);        }    }    QCloudCOSXMLService.defaultCOSXML().putObjectTagging(putReq);

查询对象标签

功能说明

查询指定对象下已有的对象标签。

示例代码

Objective-C

    QCloudGetObjectTaggingRequest *getReq = [QCloudGetObjectTaggingRequest new];
    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    getReq.bucket = @"examplebucket-1250000000";
    [getReq setFinishBlock:^(QCloudTagging * result, NSError * error) {
        // tag的集合        QCloudTagSet * tagSet = result.tagSet;    }];    [[QCloudCOSXMLService defaultCOSXML] GetObjectTagging:getReq];

Swift

    let getReq = QCloudGetObjectTaggingRequest();
    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    getReq.bucket = "examplebucket-1250000000";
    req.finishBlock = {(result,error) in        if let result = result {            // tag的集合            let tagSet = result.tagSet;        } else {            print(error!);        }    }
    QCloudCOSXMLService.defaultCOSXML().getObjectTagging(getReq);

删除对象标签

注意 COS iOS SDK 版本需要大于等于 v5.9.9。

功能说明

删除指定对象下已有的对象标签。

请求示例

Objective-C

    QCloudDeleteObjectTaggingRequest *request = [QCloudDeleteObjectTaggingRequest new];
    // 文件名    request.object = @"test.png";    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    request.bucket = @"examplebucket-1250000000";    request.versionId = @"versionId";
    [request setFinishBlock:^(id * result, NSError * error) {
        if(!error){            // 删除成功        }else{            // 删除失败        }    }];    [[QCloudCOSXMLService defaultCOSXML] DeleteObjectTagging:request];

Swift

    let request = QCloudDeleteObjectTaggingRequest();
    // 文件名    request.object = "test.png";
    // 存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket    request.bucket = "examplebucket-1250000000";
    request.versionId = "versionId";
    req.finishBlock = {(result,error) in        if(!error){            // 删除成功        }else{            // 删除失败        }    }
    QCloudCOSXMLService.defaultCOSXML().deleteObjectTagging(request); 



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠