PutBucketTags - - 阿里雲

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。最大長度為64位元組。不能以`http ://`、`https://`、`Aliyun`為首碼。必須為UTF-8編碼；不可為空。子項目：無父元素：Tag
Value	字串	否	指定Bucket Tag的Value。最大長度為128位元組。必須為UTF-8編碼。可以為空白。子項目：無父元素：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如下：