Коды состояний и ошибок

Операции REST API для службы хранилища Azure возвращают стандартные коды состояния HTTP, как определено в определениях кода состояния HTTP/1.1.

Операции API также могут возвращать дополнительные сведения об ошибках, определенные службой. Эти дополнительные сведения об ошибке возвращаются в тексте ответа.

Текст ответа со сведениями об ошибке имеет основной формат, показанный ниже. Элемент code указывает строку кода ошибки, а message элемент — строку сообщения об ошибке.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>string-value</Code>  
  <Message>string-value</Message>  
</Error>  

Для версии 2017-07-29 и более поздних сбой операций API также возвращает строку кода ошибки службы хранилища Azure в заголовке ответа.

Заголовок ответа Описание
x-ms-error-code Значение, указывающее строку кода ошибки.

Конкретный ответ на ошибку также может содержать дополнительные сведения об ошибке, чтобы предоставить разработчику дополнительные сведения. Например, следующий ответ об ошибке указывает, что параметр запроса, указанный в URI запроса, недопустим, и предоставляет дополнительные сведения о имени и значении недопустимого параметра, а также о причине ошибки.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>InvalidQueryParameterValue</Code>  
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>  
  <QueryParameterName>popreceipt</QueryParameterName>  
  <QueryParameterValue>33537277-6a52-4a2b-b4eb-0f905051827b</QueryParameterValue>  
  <Reason>invalid receipt format</Reason>  
</Error>  

В следующих разделах приведены списки кодов ошибок, которые могут оказаться полезными:

Ответы на ошибки для хранилища таблиц

Ответы на ошибки для хранилища таблиц соответствуют формату ошибок, описанному в разделе 19 спецификации OData. Могут быть включены дополнительные сведения об ошибке, но ответ на ошибку всегда соответствует спецификации OData .

Ответы на ошибки пакетной службы аналогичны стандартным ответам на ошибки хранилища таблиц. Дополнительные сведения см. в статье о выполнении транзакций для группы сущностей.

Примечание

JSON — это рекомендуемый формат полезных данных для хранилища таблиц. Это единственный формат, поддерживаемый для версии 2015-12-11 и более поздних версий.

Ниже показан основной текст ошибки в формате JSON (версия 2013-08-15 и более поздние версии):

{"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"}}}  
  

Ниже показан основной текст ошибки в формате Atom (версии до 2015-12-11):

<?xml version="1.0" encoding="utf-8"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>ResourceNotFound</code>  
  <message xml:lang="en-US">The specified resource does not exist.  
RequestId:e288ba1e-f5dd-4014-9e09-f1263d223dec  
Time:2014-06-04T16:18:20.7088013Z</message>  
</error>  
  

См. также раздел

Устранение неполадок с операциями API
Перечисление HttpStatusCode
REST служб хранилища