对象存储

    • 对象存储 > API 文档 > Bucket 接口 > 设置空间标签

    设置空间标签

    最近更新时间: 2023-03-01 17:47:42

    描述

    本接口用于设置空间标签，包括新增和修改。


    请求

    请求语法

    PUT /bucketTagging?bucket=<BucketName> HTTP/1.1
Host: uc.qiniuapi.com
Content-Type: application/json
X-Qiniu-Date: 20060102T150405Z
Authorization: Qiniu <AccessToken>

{
    "Tags":[  
            {"Key":xx, "Value": xx},
            {"Key":xx, "Value": xx},
            ...
        ]
}

    使用说明：

    • 标签（tag）是 Key-Value的结构，同一个Bucket下，Key必须是唯一的, 且一个Key只能有1个Value，Key设置重复时服务端会返回400: tag contain duplicate key。

    • 每个Bucket最多可以设置10对标签，超出限制时服务端会返回400: tag num exceed limit。

    • API是覆盖语义，调用时会替换整个Bucket的标签，比如：原来Bucket有10对标签, 想更新其中1对，request.body应该包含9对old tag + 1对 new tag。


    请求参数

    参数名称 必填 说明
    BucketName 是 空间名称
    Key 是 标签名称，最大64Byte，不能为空且大小写敏感，不能以kodo为前缀(预留), 不支持中文字符，可使用的字符有：字母，数字，空格，+ - = . _ : / @
    Value 是 标签值，最大128Byte，不能为空且大小写敏感，不支持中文字符，可使用的字符有：字母，数字，空格，+ - = . _ : / @

    请求头

    该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅公共请求头。


    请求内容

    该请求操作的请求体为空。


    响应

    响应头

    该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。


    响应内容

    该请求操作的响应体为空。


    响应状态码

    该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。


    示例

    请求示例

    PUT /bucketTagging?bucket=temp-bucket-jnacytgvzwpgiotaprp1z0 HTTP/1.1
Host: uc.qiniuapi.com
User-Agent: Go-http-client/1.1
Content-Length: 0
X-Qiniu-Date: 20060102T150405Z
Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:yfdfCaZNBlgi2HACEXRSgycc8IY=
Content-Type: application/json 

{
	"Tags": [
		{
			"Key": "KODO-BUKCET-TAGS-key-qyxvhJ0b3l",
			"Value": "KODO-BUKCET-TAGS-value-tUwjRvCVzz"
		}
	]
}

    响应示例

    HTTP/1.1 200 OK
Content-Length: 2
Connection: keep-alive
Content-Type: application/json
Date: Mon, 02 Jan 2006 15:04:05 GMT
X-Reqid: rWkAAFTxT13GrdYV

{}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close