Status and Error Codes

Status and Error Codes


Updated: August 4, 2015

REST API operations for Azure storage services return standard HTTP status codes, as defined in the HTTP/1.1 Status Code Definitions.

API operations may also return additional error information that is defined by the storage service. This additional error information is returned in the response body.

The body of the error response follows the basic format shown here. The code element indicates the storage service error code string, whereas the message element indicates the error message string.

<?xml version="1.0" encoding="utf-8"?>

A given error response may also include additional error information to provide the developer with more information about the error. For example, the following error response indicates that a query parameter specified on the request URI was invalid, and provides additional information about the invalid parameter's name and value and the reason for the error.

<?xml version="1.0" encoding="utf-8"?>
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>
  <Reason>invalid receipt format</Reason>

The following topics provide lists of error codes for the Blob, Queue, Table, and File services:

Error responses for the Table service include the storage services error code and message elements, as shown above, but are also compliant with the error format described in section 19 of the OData specification. Additional error information may be included in the response in addition to the storage services error code and message, but the error response will always comply with the OData spec.

Batch error responses are similar to standard Table service error responses and are described in detail in Performing Entity Group Transactions.

Basic Error Body in Atom Format

<?xml version="1.0" encoding="utf-8"?>
<error xmlns="">
  <message xml:lang="en-US">The specified resource does not exist.

Basic Error Body in JSON Format

{"odata.error":{"code":"ResourceNotFound","message":{"lang":"en-US","value":"The specified resource does not exist.\nRequestId:102a2b55-eb35-4254-9daf-854db78a47bd\nTime:2014-06-04T16:18:20.4307735Z"}}}

© 2015 Microsoft