更新时间:2023-12-27 GMT+08:00
分享

HTTP状态码(Java SDK)

OBS服务端遵照HTTP规范,在接口调用完成均会返回标准的HTTP状态码,HTTP状态码分类以及OBS中常见的HTTP状态码如下:

  • HTTP状态码分类:

    分类

    分类描述

    1XX

    信息,服务器收到请求,需要请求者继续执行操作,一般对客户调用函数不可见。

    2XX

    成功,操作被成功接收并处理。

    3XX

    重定向,需要进一步的操作以完成请求,一般对客户调用函数不可见。

    4XX

    客户端错误,请求包含语法错误或无法完成请求。

    5XX

    服务器错误,服务器在处理请求的过程中发生了错误。

  • OBS中常见的HTTP状态码及其含义:

    HTTP状态码

    描述

    常见原因

    400 Bad Request

    请求参数错误

    • 请求参数不合法;
    • 客户端携带MD5请求后一致性校验失败;
    • 无效的参数(使用SDK时传递了不合法的参数);
    • 无效的桶名(使用了不合法的桶名)。

    403 Forbidden

    拒绝访问

    • 客户端请求中携带的签名和服务端计算出的签名不匹配(一般是AK/SK错误);
    • 权限不足(账号对请求的资源无权限);
    • 账号欠费;
    • 桶的空间不足(出现在对桶设置了配额的场景);
    • 无效的AK;
    • 客户端时间和服务端时间相差过大(客户端所在机器的时间与NTP服务不同步)。

    404 Not Found

    请求的资源不存在

    • 桶不存在;
    • 对象不存在;
    • 桶的策略配置不存在(桶CORS配置不存在、桶Policy配置不存在等);
    • 分段上传任务不存在。

    405 Method Not Allowed

    请求的方法不支持

    请求的方法/特性未在该桶所在的区域上线。

    408 Request Timeout

    请求超时

    服务端与客户端Socket连接超时。

    409 Conflict

    请求冲突

    • 在不同区域重复创建同名桶;
    • 尝试删除非空桶。

    500 Internal Server Error

    服务端内部错误

    服务端内部错误。

    503 Service Unavaliable

    服务不可用

    服务端暂时不可访问。

相关文档