赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 标签(Tags)
  8. PutBucketTags

PutBucketTags

  • 标签(Tags)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

PutBucketTags接口用来给某个存储空间(Bucket)添加或修改标签。

注意事项

使用PutBucketTags接口时,有如下注意事项:

  • 如需调用PutBucketTags为Bucket添加或修改标签,您必须拥有oss:PutBucketTagging权限。具体操作,请参见为RAM用户授权自定义的权限策略。

  • 只有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如下:

  • Java

  • PHP

  • Node.js

  • Python

  • .NET

  • Go V2

  • C++

命令行工具ossutil

PutBucketTags接口所对应的ossutil命令,请参见put-bucket-tags。

相关文章

PutBucketTags 2025-04-21 18:15

PutBucketTags接口用来给某个存储空间(Bucket)添加或修改标签。 注意事项

GetBucketTags 2025-04-21 18:15

GetBucketTags用于获取存储空间(Bucket)的标签信息。 注意事项 如需调用GetBucketTags获取Bucket的标签信息,您必须拥有oss:GetBucketTagging权限。具体操作,请参见为RAM用户授权自定义的权限策略。

DeleteBucketTags 2025-04-21 18:15

DeleteBucketTags接口用于删除存储空间(Bucket)标签。 注意事项 如需调用DeleteBucketTags删除Bucket标签,您必须拥有oss:DeleteBucketTagging权限。具体操作,请参见为RAM用户授权自定义的权限策略。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号