PutBucketTags
PutBucketTags接口用来给某个Bucket添加或修改标签。
说明
- 只有Bucket的拥有者及授权子账户才能为Bucket设置用户标签,否则返回403 Forbidden错误,错误码为AccessDenied。
- 最多可设置20对Bucket用户标签(Key-Value对)。
- PutBucketTags是覆盖语义,即新Put的标签会完全覆盖已有的标签。
请求语法
PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLengt
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>
请求元素
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
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 |
示例
- 请求示例
PUT /?tagging Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 20 Dec 2018 11:49:13 GMT Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3**** <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: 5C1B138A109F4E405B2D8AEF date: Thu, 20 Dec 2018 11:59:06 GMT x-oss-server-time: 148 connection: keep-alive
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论