OSS存储开放接口规范 和 错误响应

1、开放接口规范

        开发者在发送请求给 OSS 时，既可以使用 带签名认证的请求，也可以使用匿名访问。OSS提供的相关API接口如下:

关于Service操作

关于Bucket的操作

关于Object的操作

关于Multipart Upload的操作

跨域资源共享（CORS）

关于Live Channel的操作

2、OSS云存储错误响应

        当用户访问OSS出现错误时，OSS会返回给用户相应的错误码和错误信息，便于用户定位问题，并做出适当的处理。

（1）OSS的错误响应格式

        当用户访问OSS出错时，OSS会返回给用户一个合适的3xx，4xx或者5xx的HTTP状态码；以及一个application/xml格式的消息体。

错误响应的消息体例子：

"1.0" ?>
<Error xmlns=”http://doc.oss.aliyuncs.com”>
    <Code>
        AccessDenied
    Code>
    <Message>
        Query-string authentication requires the Signature, Expires and OSSAccessKeyId parameters
    Message>
    <RequestId>
        1D842BC5425544BB
    RequestId>
    <HostId>
        oss.aliyuncs.com
    HostId>
Error>

所有错误的消息体中都包括以下几个元素：

• Code：OSS返回给用户的错误码。
• Message：OSS给出的详细错误信息。
• RequestId：用于唯一标识该次请求的UUID；当你无法解决问题时，可以凭这个RequestId来请求OSS开发工程师的帮助。
• HostId：用于标识访问的OSS集群（目前统一为oss.aliyuncs.com）

（2）OSS的错误码

3、OSS参数不支持的操作

        如果在OSS合法的操作中，添加了OSS不支持的请求头参数（例如在PUT的时候，加入If-Modified-Since参数），OSS会返回501 Not Implemented错误

错误请求示例：

PUT /my-image.jpg HTTP/1.1
Host:oss-example. oss.aliyuncs.com
Date: Wed, 28 May 2011 22:32:00 GMT
If-Modified-Since: Wed, 06 Apr 2011 10:02:46 GMT

返回示例： 

501 Not Implemented
x-oss-request-id: 77E534EBF90372BE
Content-Type: application/xml
Transfer-Encoding: chunked
Date: Thu, 28 Apr 2011 08:03:07 GMT
Connection: close
Server: AliyunOSS
 
 
"1.0" ?>
<Error xmlns=”http://doc.oss.aliyuncs.com”>
    <Code>
        NotImplemented
    Code>
    <Message>
        A header you provided implies functionality that is not implemented.
    Message>
    <Header>
        If-Modified-Since
    Header>
    <RequestId>
        77E534EBF90372BE
    RequestId>
    <HostId>
        oss.aliyuncs.com
    HostId>
Error>

其他错误类似，这里只是介绍了一个示例。我们要学会观看响应体，并寻找错误源头，定位错误。