腾讯云对象存储对象标签

简介

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

设置对象标签

功能说明

COS 支持为已存在的对象设置标签。PUT Object tagging 接口通过为对象添加键值对作为对象标签，可以协助您分组管理已有的对象资源，详情请参见 对象标签概述。

方法原型

func (s *ObjectService) PutTagging(ctx context.Context, name string, opt *ObjectPutTaggingOptions, id ...string) (*Response, error)

请求示例

package main
import (    "context"    "github.com/tencentyun/cos-go-sdk-v5"    "net/http"    "net/url"    "os"    "strings")
func main() {    // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket    // 替换为用户的 region，存储桶 region 可以在 COS 控制台“存储桶概览”查看 https://console.cloud.tencent.com/ ，关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 。    u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")    b := &cos.BaseURL{BucketURL: u}    client := cos.NewClient(b, &http.Client{        Transport: &cos.AuthorizationTransport{            // 通过环境变量获取密钥            // 环境变量 SECRETID 表示用户的 SecretId，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretID: os.Getenv("SECRETID"),  // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140            // 环境变量 SECRETKEY 表示用户的 SecretKey，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretKey: os.Getenv("SECRETKEY"),  // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140        },    })    // Case1 通过 PutTagging 设置云上对象标签    opt := &cos.ObjectPutTaggingOptions{        TagSet: []cos.ObjectTaggingTag{            {                Key:   "test_k2",                Value: "test_v2",            },            {                Key:   "test_k3",                Value: "test_v3",            },        },    }    name := "example"    _, err := client.Object.PutTagging(context.Background(), name, opt)    if err != nil {        //ERROR    }        // Case2 上传时设置对象标签    name = "test/example"    f := strings.NewReader("test")    popt := &cos.ObjectPutOptions{        ObjectPutHeaderOptions: &cos.ObjectPutHeaderOptions{            XOptionHeader: &http.Header{},        },    }    popt.XOptionHeader.Add("x-cos-tagging", "Key1=Value1&Key2=Value2")    _, err = client.Object.Put(context.Background(), name, f, popt)} 

参数说明

type ObjectPutTaggingOptions struct {    TagSet  []ObjectTaggingTag}type BucketTaggingTag struct {    Key   string    Value string}

查询对象标签

功能说明

GET Object tagging 接口用于查询指定对象下已有的对象标签。

方法原型

func (s *ObjectService) GetTagging(ctx context.Context, name string, id ...string) (*ObjectGetTaggingResult, *Response, error)

请求示例

package main
import (    "context"    "fmt"    "github.com/tencentyun/cos-go-sdk-v5"    "net/http"    "net/url"    "os")
func main() {    // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket    // 替换为用户的 region，存储桶 region 可以在 COS 控制台“存储桶概览”查看 https://console.cloud.tencent.com/ ，关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 。    u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")    b := &cos.BaseURL{BucketURL: u}    client := cos.NewClient(b, &http.Client{        Transport: &cos.AuthorizationTransport{            // 通过环境变量获取密钥            // 环境变量 SECRETID 表示用户的 SecretId，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretID: os.Getenv("SECRETID"),  // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140            // 环境变量 SECRETKEY 表示用户的 SecretKey，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretKey: os.Getenv("SECRETKEY"),  // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140        },    })    name := "example"    res, _, err := client.Object.GetTagging(context.Background(), name)    if err != nil {        //ERROR    }    fmt.Println(res)}

结果说明

type ObjectGetTaggingResult struct {    TagSet  []ObjectTaggingTag}type BucketTaggingTag struct {    Key   string    Value string}

删除对象标签

功能说明

DELETE Object tagging 接口用于删除指定对象下已有的对象标签。

方法原型

func (s *ObjectService) DeleteTagging(ctx context.Context, name string, id ...string) (*Response, error)

请求示例

package main
import (    "context"    "github.com/tencentyun/cos-go-sdk-v5"    "net/http"    "net/url"    "os")
func main() {    // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket    // 替换为用户的 region，存储桶 region 可以在 COS 控制台“存储桶概览”查看 https://console.cloud.tencent.com/ ，关于地域的详情见 https://cloud.tencent.com/document/product/436/6224 。    u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")    b := &cos.BaseURL{BucketURL: u}    client := cos.NewClient(b, &http.Client{        Transport: &cos.AuthorizationTransport{            // 通过环境变量获取密钥            // 环境变量 SECRETID 表示用户的 SecretId，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretID: os.Getenv("SECRETID"),  // 用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140            // 环境变量 SECRETKEY 表示用户的 SecretKey，登录访问管理控制台查看密钥，https://console.cloud.tencent.com/cam/capi            SecretKey: os.Getenv("SECRETKEY"),  // 用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140        },    })    name := "example"    _, err := client.Object.DeleteTagging(context.Background(), name)    if err != nil {        //ERROR    }}



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