全部產品
Search
文件中心

:PutBucketTags

更新時間:Jun 19, 2024

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如下: