对象存储

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

    设置空间标签

    最近更新时间:2019-11-13 18:10:05

    描述

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


    请求



    语法

    PUT /bucketTagging?bucket=<BucketName> HTTP/1.1
    Host: uc.qbox.me
    Content-Type: application/json
    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.qbox.me
    User-Agent: Go-http-client/1.1
    Content-Length: 0
    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: Wed, 13 Nov 2019 09:09:47 GMT
    X-Log: BUCKET:1 
    X-Reqid: rWkAAFTxT13GrdYV
    
    {}
    
    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close