Поделиться через

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

Операции 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>

Для версии 2024-08-04 и более поздних версия ответ об ошибке будет содержать подробные сведения об ошибке, если тип подписанного ресурса SAS учетной записи не соответствует ресурсу, к которому осуществляется доступ. Например, в следующем ответе об ошибке указано, что для выполнения операции требуется подписанный тип ресурса "o".

<?xml version="1.0" encoding="utf-8"?>
<Error>
  <Code>AuthorizationResourceTypeMismatch</Code>
  <Message>This request is not authorized to perform this operation using this resource type. RequestId:42a48a49-201e-0092-3770-a7ea70000000 Time:2024-05-16T09:04:16.3226200Z</Message>
  <ExtendedErrorDetail>SignedResourceTypes 'o' is required to perform this operation.</ExtendedErrorDetail>
</Error>

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

Ответ об ошибке Copy API

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

Для версий 2024-02-04 и более поздних ответ об ошибке может содержать подробные сведения об ошибке, если операция копирования завершается сбоем из-за проблемы с источником копирования, при условии, что сбой из источника возвращает эти сведения. Ответ может включать CopySourceStatusCode указание кода состояния операции копирования источника, CopySourceErrorCode указание возвращенного x-ms-error-code в ответе об ошибке источника копирования и CopySourceErrorMessage указание соответствующего сообщения об ошибке.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>CannotVerifyCopySource</Code>  
  <Message> The specified blob doesn’t exist.
      RequestId:de1e2279-b01e-0000-5f26-5c4741000000
      Time:2023-03-21T18:52:10.1018932Z</Message>
  <CopySourceStatusCode> 404 </CopySourceStatusCode>
  <CopySourceErrorCode> BlobNotFound </CopySourceErrorCode>
  <CopySourceErrorMessage> The specified blob doesn’t exist </CopySourceErrorMessage> 
</Error>

Для версий 2024-02-04 и более поздних версий служба хранилища Azure возвращает код состояния источника копирования и код ошибки в заголовке ответа, если они были получены в результате сбоя копирования источника.

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

Следующие API копирования возвращают следующие сведения:

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

Ответы об ошибках для Table Storage соответствуют формату ошибок, описанному в разделе 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