If an error occurs when you access Object Storage Service (OSS), OSS returns an HTTP status code and a response that contains a message body in the application/xml format. You can identify and rectify the error based on the returned HTTP status code and response.

Response message body

The following example shows the message body of an error response:

<?xml version="1.0" ?>
<Error xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
        Query-string authentication requires the Signature, Expires and OSSAccessKeyId parameters

The message body of an error response contains the following elements:

  • Code: the error code returned by OSS.
  • Message: the detailed error message provided by OSS.
  • RequestId: the UUID that uniquely identifies the error request. You can provide the request ID for contact technical support to locate and resolve your issues. For more information about how to obtain the ID of a request, see Obtain request IDs.
  • HostId: the ID of the host in the accessed OSS cluster, which is the same as the host ID specified in the request.

Sample error request and response

If parameters that are not supported by OSS are added to requests to call operations supported by OSS, for example, the If-Modified-Since parameter is added to the PUT operation request, OSS returns 400 Bad Request.

Sample error requests
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
Sample responses
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"?>
  <Message>A header you provided implies functionality that is not implemented.</Message>

For more information about OSS error codes, visit OSS error center.

Common errors and troubleshooting


For more information about troubleshooting, see the FAQ topics for OSS features and tools. You can view the following FAQ topics for OSS SDKs for different programming languages and OSS tools for troubleshooting: