获取对象标签

GetObjectTagging

GetObjectTagging操作可以查询对象的标签信息，标签是一个键值对，每个对象最多可以有10个标签。bucket的拥有者默认拥有查询bucket中对象的标签的权限，并且可以将权限授予其他用户。

代码示例：

// 获取对象标签
func GetObjectTagging(svc *s3.S3) {
    getObjectTaggingInput := &s3.GetObjectTaggingInput{
        Bucket: aws.String("exampleBucket"),
        Key:    aws.String("exampleKey"),
    }

    getObjectTaggingOutput, err := svc.GetObjectTagging(getObjectTaggingInput)
    if err != nil {
        fmt.Printf("fail to get object tagging. %v\n", err)
        return
    }
    fmt.Println(getObjectTaggingOutput)
}

GetObjectTaggingInput可设置的参数如下：

参数	类型	说明	是否必要
Bucket	*string	执行本操作的桶名称。	是
Key	*string	想获取标签信息的对象的key。	是
VersionId	*string	想获取标签信息的对象的版本Id	否

GetObjectTaggingOutput返回的属性如下：

参数	类型	说明
TagSet	[]*Tag	对象标签信息数组，数组中的每一项包含了标签Key和Value的值。

GetObjectTaggingRequest

GetObjectTaggingRequest操作首先生成一个"request.Request"对象，该对象是一个执行GetObjectTaggingRequest操作的请求。通过调用Request对象的Send方法来完成获取对象标签信息的操作。该方法可以生成定制化的请求，例如自定义请求头部请求超时重试设置。

代码示例：

func GetObjectTaggingRequest(svc *s3.S3) {
    getObjectTaggingInput := &s3.GetObjectTaggingInput{
        Bucket: aws.String("exampleBucket"),
        Key:    aws.String("exampleKey"),
    }
    req, resp := svc.GetObjectTaggingRequest(getObjectTaggingInput)

    err := req.Send()
    if err != nil {
        fmt.Printf("fail to get object tagging. %v\n", err)
    } else {
        fmt.Println(resp)
    }
}

响应结果：

HTTP状态	响应码	描述
200	Success	操作成功。
400	InvalidBucketName	请求中设置桶的名字不合法。
400	InvalidObjectName	请求中设置对象的名字不合法
403	AccessDenied	用户没有权限执行操作。
404	NoSuchBucket	请求参数中设置的桶不存在。
404	NoSuchKey	请求参数中设置的对象key或者版本Id不存在。