使用EC错误码自助排查

当访问OSS出现错误时,OSS返回的错误信息中包含EC,EC与错误原因一一对应。本文介绍如何通过EC查找问题原因并自助解决问题。

背景信息

每一个错误原因对应唯一的EC。

例如,您发起了AppendObject请求,但是请求URL中的position参数不是合法的正整数。

  • 错误请求

    POST /example?append&position=test HTTP/1.1 
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
    Date: Thu, 11 Aug 2019 01:44:54 GMT
    Content-Length: 322
    Content-Type: application/octet-stream
    Authorization: OSS qn6q**************:77Dv****************
  • 返回示例

    返回结果中包含<EC>0016-00000502</EC> ,作为该错误原因的唯一标识。

    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>MissingArgument</Code>
      <Message>Missing Some Required Arguments.</Message>
      <RequestId>57ABD896CCB80C366955****</RequestId>
      <HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId> 
      <EC>0016-00000502</EC> 
      <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0016-00000502</RecommendDoc>
    </Error>

操作步骤

通过以上错误请求示例返回的EC查找问题原因及对应解决方法的操作步骤如下。

  1. 打开对象存储OSS产品文档首页

  2. OSS文档首页右上角,单击输入文档关键字查找搜索框。

  3. 在搜索框中,输入EC,例如0016-00000502。

    search1

  4. 在搜索结果列表中,单击目标EC文档。