对象存储

  • 错误响应

    最近更新时间:2017-11-21 17:42:32

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


    错误响应格式

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

    • 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 响应头部)通过邮件发送给我们。情况严重时请直接拨打 400-808-9176 转 2 上报给运维部,我们将尽快处理。

    以上内容是否对您有帮助?
  • 提交工单