错误码概述 - 对象存储 OSS

当访问OSS出现错误时，OSS会返回Code、Message、RequestId等信息，方便您定位并解决问题。

错误响应消息体

错误响应的消息体示例如下：

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

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

Code：OSS返回给用户的错误码。
Message：OSS给出的详细错误消息。
RequestId：用于唯一标识该次请求的UUID。您可以凭借此Request ID请求协助，排查并解决您遇到的问题。有关获取Request ID的多种方式，请参见获取Request ID。
HostId：用于标识访问的OSS集群，与用户请求时使用的Host一致。

错误请求和返回示例

如果在OSS支持的操作中添加了OSS不支持的参数，例如PUT操作中添加了If-Modified-Since参数，OSS将返回400 Bad Request错误。

错误请求示例如下：

PUT /abc.zip HTTP/1.1
Host: bucketname.oss-cn-shanghai.aliyuncs.com
Accept: */*
Date: Thu, 11 Aug 2019 01:44:50 GMT
If-Modified-Since: Thu, 11 Aug 2019 01:43:51 GMT
Content-Length: 363

返回示例如下：

HTTP/1.1 400 Bad Request
Server: AliyunOSS
Date: Thu, 11 Aug 2019 01:44:54 GMT
Content-Type: application/xml
Content-Length: 322
Connection: keep-alive
x-oss-request-id: 57ABD896CCB80C366955****
x-oss-server-time: 0
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NotImplemented</Code>
  <Message>A header you provided implies functionality that is not implemented.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>bucketname.oss-cn-shanghai.aliyuncs.com</HostId>
  <Header>If-Modified-Since</Header>
</Error>

更多OSS错误码信息，请参见OSS错误中心。