对象存储 > 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)接口时，指定非法的`marker`参数。
701	在断点续上传过程中，后续上传接收地址不正确或`ctx`信息已过期。

如遇 5xx 系列错误，请将完整的错误信息（包括所有的 HTTP 响应头部）提交工单给我们。

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