全部产品
Search
文档中心

对象存储 OSS:错误码概述

更新时间:Dec 14, 2023

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

错误响应头

HTTP/1.1 403 Forbidden
Server: AliyunOSS
Date: Wed, 09 Nov 2022 08:45:46 GMT
Content-Type: application/xml
Content-Length: 471
Connection: keep-alive
x-oss-request-id: 636B68BA80DA8539399F****
x-oss-server-time: 0
x-oss-ec: 0003-00000001

以下错误响应头说明如下:

响应头

说明

x-oss-ec

OSS的一种细粒度错误码。每一个错误原因对应一个唯一的EC(Error Code)。相比于错误响应体XML中的Code,EC能更加精确地反映请求出错的原因,同时也方便检索对应的解决方案。如果某个请求出现错误,EC会出现在该请求对应的HTTP响应中的响应头(x-oss-ec)和响应体XML中(/Error/EC)。您可以通过EC精确查找错误原因和解决方法。

重要

EC仅用于问题定位,有可能发生变化,不保证前向兼容。因此,您的业务逻辑不应该依赖于EC错误码。

关于错误响应头中包含的Content-Length,Connection,x-oss-request-id等公共响应头的更多信息,请参见公共响应头(Common Response Headers)

错误响应体

<?xml version="1.0" ?>
<Error xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
  <Code>MalformedXML</Code>
  <Message>The XML you provided was not well-formed or did not validate against our published schema.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
  <EC>0031-00000001</EC>
  <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>

以上错误响应体包含的响应元素说明如下:

响应元素

说明

Code

错误响应体返回的错误码。

Message

错误响应体返回的详细错误消息。

RequestId

用于唯一标识该次请求的UUID。您可以凭借此Request ID联系技术支持,排查并解决您遇到的问题。

HostId

用于标识访问的OSS集群,与用户请求时使用的Host一致。

EC

OSS的一种细粒度错误码。每一个错误原因对应一个唯一的EC(Error Code)。相比于错误响应体XML中的Code,EC能更加精确地反映请求出错的原因,同时也方便检索对应的解决方案。如果某个请求出现错误,EC会出现在该请求对应的HTTP响应中的响应头(x-oss-ec)和响应体XML中(/Error/EC)。您可以通过EC精确查找错误原因和解决方法。

重要

EC仅用于问题定位,有可能发生变化,不保证前向兼容。因此,您的业务逻辑不应该依赖于EC错误码。

RecommendDoc

EC对应的OpenAPI问题诊断链接。您可以单击该链接,然后进行自助排查。

相关文档