Self-help troubleshooting by using error codes - Object Storage Service

If an error occurs when you access Object Storage Service (OSS) resources, OSS returns an error message that contains an error code. Each error code corresponds to a specific error cause. This topic describes how to use an error code to identify the cause of an error and troubleshoot the error.

Background information

Each error code corresponds to a specific error cause.

For example, you initiate an AppendObject request, but the position parameter in the request URL is not a valid positive integer.

Sample request

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****************

Sample response

The response contains the <EC>0016-00000502</EC> element, which provides an error code that uniquely identifies the cause of the error.

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>

Self-help troubleshooting

This section provides an example on how to use the error code that is returned in the preceding response to locate the troubleshooting page:

Go to the OSS documentation homepage.
In the upper-left corner, click the Search for Help Content search box.
In the search box, enter the error code 0016-00000502.
In the search results list, click the matching error code topic.