PutBucketTags介面用來給某個儲存空間(Bucket)添加或修改標籤。
注意事項
使用PutBucketTags介面時,有如下注意事項:
只有Bucket的擁有者及授權RAM賬戶才能為Bucket設定使用者標籤,否則返回403 Forbidden錯誤,錯誤碼為AccessDenied。
最多可設定20對Bucket使用者標籤(Key-Value對)。
PutBucketTags是覆蓋語義,即新添加的標籤會完全覆蓋已有的標籤。
請求文法
PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
<TagSet>
<Tag>
<Key>key1</Key>
<Value>value1</Value>
</Tag>
<Tag>
<Key>key2</Key>
<Value>value2</Value>
</Tag>
</TagSet>
</Tagging>
要求標頭
此介面僅涉及公用要求標頭,詳情請參見公用要求標頭(Common Request Headers)。
請求元素
名稱 | 類型 | 是否必需 | 描述 |
Tagging | 容器 | 是 | 設定Bucket TagSet的容器。 子項目:TagSet 父元素:無 |
TagSet | 容器 | 是 | 包含一系列Bucket Tag的容器。 子項目:Tag 父元素:Tagging |
Tag | 容器 | 是 | 設定Bucket Tag的容器。 子項目:Key、Value 父元素:TagSet |
Key | 字串 | 是 | 指定Bucket Tag的Key。
子項目:無 父元素:Tag |
Value | 字串 | 否 | 指定Bucket Tag的Value。
子項目:無 父元素:Tag |
回應標頭
此介面僅涉及公用回應標頭,詳情請參見公用回應標頭(Common Response Headers)。
樣本
請求樣本
PUT /?tagging Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 20 Dec 2018 11:49:13 GMT Authorization: OSS qn6q**************:77Dv**************** <Tagging> <TagSet> <Tag> <Key>testa</Key> <Value>testv1</Value> </Tag> <Tag> <Key>testb</Key> <Value>testv2</Value> </Tag> </TagSet> </Tagging>
返回樣本
200 (OK) content-length: 0 server: AliyunOSS x-oss-request-id: 5C1B138A109F4E405B2D**** date: Thu, 20 Dec 2018 11:59:06 GMT x-oss-server-time: 148 connection: keep-alive
SDK
此介面對應的各語言SDK如下: