jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的对象存储错误响应

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > 错误响应

#  错误响应

最近更新时间: 2021-05-13 19:02:13

本节为您提供请求出现错误时，返回的错误码和对应的错误信息。

  

# **错误响应格式**

当您请求出现错误时，响应头部信息包括：

  * Content-Type: application/json
  * 一个合适的 3xx，4xx，或者 5xx 的 HTTP 状态码

各个接口在遇到执行错误时，将返回一个 JSON 格式组织的信息对象，描述出错原因。具体格式如下：

    
    
    {
    	"code": <httpCode int>, 
        "error": "<errMsg string>"
    }
    

字段名称 | 说明  
---|---  
code | 返回的错误码，用来定位错误场景。  
error | 包含详细的错误信息  
  
  

# **错误码列表**

以下表格列出了所有错误码：

HTTP状态码 | 说明  
---|---  
298 | 部分操作执行成功  
400 | 请求报文格式错误  
包括上传时，上传表单格式错误。例如`incorrect region`表示上传域名与上传空间的区域不符，此时需要升级 SDK 版本。  
401 | 认证授权失败  
错误信息包括密钥信息不正确；数字签名错误；授权已超时，例如`token not specified`表示上传请求中没有带 token
，可以抓包验证后排查代码逻辑; `token out of date`表示 token 过期，推荐 token 过期时间设置为 3600 秒（1
小时），如果是客户端上传，建议每次上传从服务端获取新的 token；`bad token`表示 token 错误，说明生成 token
的算法有问题，建议直接使用七牛服务端 SDK 生成 token。  
403 | 权限不足，拒绝访问。  
例如`key doesn't match scope`表示上传文件指定的 key 和上传 token 中，putPolicy 的 scope
字段不符。上传指定的 key 必须跟 scope 里的 key 完全匹配或者前缀匹配；`ExpUser can only upload
image/audio/video/plaintext`表示账号是体验用户，体验用户只能上传文本、图片、音频、视频类型的文件，完成实名认证即可解决；`not
allowed`表示您是体验用户，若想继续操作，请先前往实名认证。  
404 | 资源不存在  
包括空间资源不存在；镜像源资源不存在。  
405 | 请求方式错误  
主要指非预期的请求方式。  
406 | 上传的数据 CRC32 校验错误  
413 | 请求资源大小大于指定的最大值  
419 | 用户账号被冻结  
478 | 镜像回源失败  
主要指镜像源服务器出现异常。  
502 | 错误网关  
503 | 服务端不可用  
504 | 服务端操作超时  
573 | 单个资源访问频率过高  
579 | 上传成功但是回调失败  
包括业务服务器异常；七牛服务器异常；服务器间网络异常。需要确认回调服务器接受 POST 请求，并可以给出 200 的响应。  
599 | 服务端操作失败  
608 | 资源内容被修改  
612 | 指定资源不存在或已被删除  
614 | 目标资源已存在  
630 | 已创建的空间数量达到上限，无法创建新空间。  
631 | 指定空间不存在  
640 | 调用[列举资源(list)](https://developer.qiniu.com/kodo/api/1284/list)接口时，指定非法的`marker`参数。  
701 | 在断点续上传过程中，后续上传接收地址不正确或`ctx`信息已过期。  
  
如遇 5xx 系列错误，请将完整的错误信息（包括所有的 HTTP 响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储数据格式

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > 数据格式

#  数据格式

最近更新时间: 2021-07-27 18:42:57

本节描述七牛云存储 API 中使用到的数据格式。

## EncodedEntryURI 格式

本格式用于在 URI中指定目标资源空间与目标资源名，格式如下：

    
    
    entry = '<Bucket>:<Key>'
    encodedEntryURI = urlsafe_base64_encode(entry)
    

假设 **entry** 为 `qiniuphotos:gogopher.jpg` ，则对应的 **encodedEntryURI** 为
`cWluaXVwaG90b3M6Z29nb3BoZXIuanBn` 。

# URL安全的Base64编码

URL安全的Base64编码适用于以URL方式传递Base64编码结果的场景。该编码方式的基本过程是先将内容以Base64格式编码为字符串，然后检查该结果字符串，将字符串中的加号`+`换成中划线`-`，并且将斜杠`/`换成下划线`_`。

详细编码规范请参考[RFC4648 __](https://tools.ietf.org/html/rfc4648#section-4)标准中的相关描述。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储获取 Bucket 列表

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > Service 接口 >获取 Bucket 列表

#  获取 Bucket 列表

最近更新时间: 2024-05-21 14:10:26

# **描述**

本接口作 GET 请求用来获取请求者拥有的所有存储空间列表。该接口需要您使用带 Authorization
签名认证的请求，如果使用匿名请求无法获取存储空间列表，且只能获取签名中 AccessKey 所属账户的存储空间列表。

  

# **请求**

### **请求语法**

    
    
    GET /buckets?tagCondition=<Encodedtags> HTTP/1.1
    Host: uc.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
Encodedtags | 否 | 过滤空间的标签或标签值条件，指定多个标签或标签值时同时满足条件的空间才会返回。参数值必须做[URL 安全的 Base64 编码](https://developer.qiniu.com/kodo/manual/1231/appendix#urlsafe-base64)。  
按标签名过滤空间时，参数值设置为Encoded(key=key1;key=key2)；按标签值过滤空间时，参数值设置为Encoded(key=key1&value=value1;key=key2&value=value2)  
别人授权的空间，标签属性不传递，因此依据标签列举空间时只会返回自己创建的空间  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    [
    BucketName
    ]
    

  

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **响应内容**

名称 | 说明  
---|---  
BucketName | 空间名称  
  
类型：字符串  
  
  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    GET /buckets?tagCondition=S09ETy1CVUtDRVQtVEFHUy1rZXktWDdPNjZiNkxLdz1LT0RPLUJVS0NFVC1UQUdTLXZhbHVlLWdFOGhIV2VXUGo= HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:8tgafMszuwgd99Ix4eQ2HeVT9B0=
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_

  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Content-Length: 75
    Connection: keep-alive
    Content-Type: application/json
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    X-Reqid: rWkAACgHbskB5dYV
    
    [
      "temp-bucket-xufk1x3r1wa9ayoy7knuz0", 
      "temp-bucket-pighpwdt7lu88ljltffmz0"
    ]
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储Bucket 接口

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > Bucket 接口

#  Bucket 接口

最近更新时间: 2021-12-06 10:03:53

空间管理相关的接口：

接口 | 说明  
---|---  
[mkbucketv3](https://developer.qiniu.com/kodo/api/1382/mkbucketv3) | 创建新的存储空间  
[drop](https://developer.qiniu.com/kodo/api/1601/drop-bucket) | 删除指定存储空间  
[domains](https://developer.qiniu.com/kodo/api/3949/get-the-bucket-space-domain) | 获取一个空间绑定的所有域名列表  
[image](https://developer.qiniu.com/kodo/api/3966/bucket-image-source) | 为存储空间指定一个镜像回源网址，用于取回资源  
[private](https://developer.qiniu.com/kodo/api/3946/set-bucket-private) | 设置空间访问权限  
[putBucketTagging](https://developer.qiniu.com/kodo/api/6314/put-bucket-tagging) | 设置空间标签  
[getBucketTagging](https://developer.qiniu.com/kodo/api/6315/get-bucket-tagging) | 查询空间标签  
[deleteBucketTagging](https://developer.qiniu.com/kodo/api/6316/delete-bucket-tagging) | 删除空间标签  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储创建 Bucket

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 创建
Bucket

#  创建 Bucket

最近更新时间: 2023-03-01 17:46:53

# **描述**

本接口用于创建一个新的 Bucket。此接口不支持匿名请求。您可以在请求参数中指定存储区域，例如，您在华东，选择华东存储区域可以减少延迟、降低成本。

  

# **请求**

### **请求语法**

    
    
    POST /mkbucketv3/<BucketName>/region/<Region> HTTP/1.1
    Host: uc.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu <AccessToken>
    

使用说明：

  * 如果请求的 Bucket 已经存在/重名，返回错误码 614，错误信息：目标资源已存在。

  * 如果创建的 Bucket 不符合命名规范，返回错误码 400，错误信息：invalid arguments。

  * 如果发起创建 Bucket 请求的时候，没有传入认证信息，返回错误码 401，错误信息：bad token。

  * 如果创建 Bucket 的时候超过最大创建数（默认 20 个），返回错误码 630，错误信息：too many buckets。

  * 目前 Bucket 有两种访问权限：公开和私有。创建的 Bucket，默认为公开权限。

  * Bucket 名称和其存储所在区域在创建后无法修改。

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
BucketName | 是 | 空间名称，要求**在对象存储系统范围内唯一** ，由3～63个字符组成，支持小写字母、短划线`-`和数字，且必须以小写字母或数字开头和结尾。  
Region | 否 | 存储区域 ID，默认 z0。 存储区域 ID 列表见 [存储区域列表](https://developer.qiniu.com/kodo/1671/region-endpoint-fq)  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    POST /mkbucketv3/mybucketforvideo HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    Content-Length: 0
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_

  

### **响应示例**

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

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储删除 Bucket

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 删除
Bucket

#  删除 Bucket

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

# **描述**

本接口用于删除指定的 Bucket。

  

# **请求**

### **请求语法**

    
    
    POST /drop/<BucketName> HTTP/1.1
    Host: uc.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu <AccessToken>
    

使用说明：

  * 删除存储空间后，其中保存的文件也会被删除，无法恢复。

  * 删除存储空间后，空间名称可以被重新使用。

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
BucketName | 是 | 需要删除的目标空间名  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
request-header)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    POST /drop/test05 HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nj2E4apIRDq67g_PMJ932w_2qiA=
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_

  

### **响应示例**

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

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储获取 Bucket 空间域名

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 获取
Bucket 空间域名

#  获取 Bucket 空间域名

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

# **描述**

本接口用于获取 Bucket 的域名列表。

  

# **请求**

### **请求语法**

    
    
    GET /v2/domains?tbl=<bucketName> HTTP/1.1
    Host: uc.qiniuapi.com 
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z  
    Authorization: Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
tbl | 是 | 要获取域名列表的目标空间名称  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    {
    DomainName
    }
    

  

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

名称 | 说明  
---|---  
DomainName | 空间域名  
  
类型：字符串  
  
  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    GET /v2/domains?tbl=test01 HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:jfblnkj6JsrlxgbE3l4SfhSyiL4=
    Accept-Encoding: gzip
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_

  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Connection: keep-alive
    Content-Type: application/json
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Server: nginx
    Vary: Accept-Encoding
    X-Reqid: BksAALTAQtVZhdsU
    
    [
      "oupgm4mi4.bkt.clouddn.com", 
      "sarah.qiniudemo.com"
    ]
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储设置 Bucket 镜像源

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 设置
Bucket 镜像源

#  设置 Bucket 镜像源

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

# **描述**

七牛镜像存储服务可以帮助用户实现数据热迁移，迁移过程中并不影响原有业务系统的访问。镜像存储适用于迁移原有业务系统的已有数据。

  

# **请求**

### **请求语法**

    
    
    POST /image/<BucketName>/from/<EncodedSrcSiteUrl>/host/<EncodedHost> HTTP/1.1
    Host:           uc.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

使用说明：

  * 取回动作仅在第一次访问资源不存在时发生

  * 取回动作是一个同步操作，源文件过大可能导致客户端等待超时

  * 取回动作失败时，会返回 HTTP 响应码

  * 源站同名资源的内容发生改变后，七牛云存储不会自动将新内容取回，用户需要删除空间中的资源，再[刷新预取 __](https://portal.qiniu.com/domain/refresh)才可以访问到更新后的资源

  * 多个客户端触发镜像回源时，资源的最终内容为最后一个成功执行的操作所存储的结果

  * 回源源站时，会携带固定的User-Agent信息：`<RegionID>-qiniu-imgstg-spider-1.0`，[Region(区域) ID列表](https://developer.qiniu.com/kodo/1671/region-endpoint-fq)

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
BucketName | 是 | 需要设定镜像源的目标空间名  
EncodedSrcSiteUrl | 是 | 镜像源的访问域名，必须设置为形如`http(s)://source.com`或`http(s)://114.114.114.114`的字符串。参数值必须做[URL 安全的 Base64 编码](https://developer.qiniu.com/kodo/manual/1231/appendix#urlsafe-base64)。  
EncodedHost | 否 | 回源时使用的`Host`头部值。参数值必须做[URL 安全的 Base64 编码](https://developer.qiniu.com/kodo/manual/1231/appendix#urlsafe-base64)。可以填空字符串 `""` 或不包含 `/host/<EncodedHost>` 部分，表示不额外指定 host  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    POST /image/test02/from/aHR0cHM6Ly9zYXJhaC5xaW5pdWRlbW8uY29t HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:CCiHcTjKJDdseHBrldeYFywnxWo=
    Accept-Encoding: gzip
    

  

### **响应示例**

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

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储设置 Bucket 访问权限

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 设置
Bucket 访问权限

#  设置 Bucket 访问权限

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

# **描述**

本接口用于设置 Bucket 访问权限。目前 Bucket 有两种访问权限：公开和私有。创建 Bucket 时默认为公开空间。

  

# **请求**

### **请求语法**

    
    
    POST /private?bucket=<BucketName>&private=<Private> HTTP/1.1
    Host: uc.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
bucket | 是 | 空间名称  
private | 是 | 
* `0` 公开
* `1` 私有  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    POST /private?bucket=test06&private=1 HTTP/1.1
    Host: uc.qiniuapi.com
    User-Agent: Go-http-client/1.1
    Content-Length: 23
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:YHLW5tnhbumBI56iQ0AzJdZONSY=
    Content-Type: application/x-www-form-urlencoded
    Accept-Encoding: gzip
    

  

### **响应示例**

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

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储设置空间标签

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 设置空间标签

#  设置空间标签

最近更新时间: 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，不能为空且大小写敏感，不支持中文字符，可使用的字符有：字母，数字，空格，+ - = . _ : / @  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    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
    
    {}
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储查询空间标签

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 查询空间标签

#  查询空间标签

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

# **描述**

本接口用于查询指定空间已设置的标签信息。

  

# **请求**

### **请求语法**

    
    
    GET /bucketTagging?bucket=<BucketName> HTTP/1.1
    Host: uc.qiniuapi.com
    Content-Type: application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
BucketName | 是 | 空间名称  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
     {
     "Tags":[{"Key":xx,"Value":xx}]
    }
    

  

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

名称 | 说明  
---|---  
Key | 标签名称  
Value | 标签值  
  
  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

    
    
    GET /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:z_ksteUK6jI_0MLAaHNEPFqrpqY=
    Content-Type: application/json 
    

  

### **响应示例**

    
    
    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: rWkAAGaeqzDGrdYV
    
     {
    	"Tags": [
    		{
    			"Key": "123",
    			"Value": "0000"
    		},
    		{
    			"Key": "aaaaa",
    			"Value": "bbbbb"
    		}
    	]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储删除空间标签

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Bucket
接口](https://developer.qiniu.com/kodo/api/3941/the-bucket-interface) > 删除空间标签

#  删除空间标签

最近更新时间: 2023-03-01 17:48:00

# **描述**

本接口用于一键删除指定空间的所有标签。

  

# **请求**

### **请求语法**

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

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
BucketName | 是 | 空间名称  
  
  

### **请求头**

该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-
request-headers)。

  

### **请求内容**

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

  

# **响应**

### **响应头**

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-
response-headers)。

  

### **响应内容**

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

  

### **响应状态码**

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-
responses)。

  

# **示例**

### **请求示例**

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

  

### **响应示例**

    
    
    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: rWkAAJJlhDXGrdYV
    
    {}
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储Object 接口

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > Object 接口

#  Object 接口

最近更新时间: 2021-12-06 12:19:58

对象管理相关的接口：

接口 | 说明  
---|---  
[upload](https://developer.qiniu.com/kodo/api/1312/upload) | 用于在一次 HTTP 会话中上传单一的一个对象  
[mkblk](https://developer.qiniu.com/kodo/api/1286/mkblk) | 为后续分片上传创建一个新的块，同时上传第一片数据  
[bput](https://developer.qiniu.com/kodo/api/1251/bput) | 上传指定块的一片数据，具体数据量可根据现场环境调整，同一块的每片数据必须串行上传  
[mkfile](https://developer.qiniu.com/kodo/api/1287/mkfile) | 将上传好的所有数据块按指定顺序合并成一个对象资源  
[initiateMultipartUpload](https://developer.qiniu.com/kodo/api/6365/initialize-multipartupload) | 通知服务端开启分块上传任务,得到全局唯一任务UploadId  
[uploadPart](https://developer.qiniu.com/kodo/api/6366/upload-part) | 分块上传数据，需指定的任务UploadId  
[completeMultipartUpload](https://developer.qiniu.com/kodo/api/6368/complete-multipart-upload) | 完成整个对象的分块上传，需指定的任务UploadId  
[abortMultipartUpload](https://developer.qiniu.com/kodo/api/6367/abort-multipart-upload) | 中止分块上传任务，并且删除已经上传的块，需指定的任务UploadId  
[listParts](https://developer.qiniu.com/kodo/api/6858/listparts) | 列举指定 UploadId 所属的所有已经上传成功Part  
[list](https://developer.qiniu.com/kodo/api/1284/list) | 用于列举指定空间里的所有对象条目  
[stat](https://developer.qiniu.com/kodo/api/1308/stat) | 仅获取对象的 Metadata 信息，不返回对象内容  
[chgm](https://developer.qiniu.com/kodo/api/1252/chgm) | 修改对象的 MIME 类型信息  
[move](https://developer.qiniu.com/kodo/api/1288/move) | 将源空间的指定对象移动到目标空间，或在同一空间内对对象重命名  
[copy](https://developer.qiniu.com/kodo/api/1254/copy) | 将指定对象复制为新命名对象  
[delete](https://developer.qiniu.com/kodo/api/1257/delete) | 删除指定对象  
[batch](https://developer.qiniu.com/kodo/api/1250/batch) | 指在单一请求中执行多次获取元信息、移动、复制、删除操作，极大提高对象管理效率  
[chstatus](https://developer.qiniu.com/kodo/api/4173/modify-the-file-status) | 修改对象的存储状态，即切换启用、禁用状态  
[chtype](https://developer.qiniu.com/kodo/api/3710/chtype) | 修改对象的存储类型信息，即低频存储、标准存储和归档存储的互相转换  
[restoreAr](https://developer.qiniu.com/kodo/api/6380/restore-archive) | 解冻归档存储类型的对象  
[deleteAfterDays](https://developer.qiniu.com/kodo/api/1732/update-file-lifecycle) | 设置一个对象多少天后过期删除  
[lifecycle](https://developer.qiniu.com/kodo/api/8062/modify-object-life-cycle) | 修改已上传对象的生命周期，即修改对象转低频时间、转归档时间、过期删除时间  
[prefetch](https://developer.qiniu.com/kodo/api/1293/prefetch) | 对于设置了镜像存储的空间，从镜像源站抓取指定名称的对象并存储到该空间中  
[sisyphus/fetch](https://developer.qiniu.com/kodo/api/4097/asynch-fetch) | 从指定 URL 抓取对象，并将该对象存储到指定空间中。每次只抓取一个对象，抓取时可以指定保存空间名和最终对象名  
  
  

以上内容是否对您有帮助？