Status e códigos de erro

As operações da API REST para serviços de armazenamento do Azure retornam códigos de status HTTP padrão, conforme definido nas Definições de código de status HTTP/1.1.

As operações da API também podem retornar informações de erro adicionais que são definidas pelo serviço de gerenciamento. Essas informações de erro adicionais são retornadas no corpo de resposta.

O corpo da resposta de erro apresenta o formato básico mostrado a seguir. O elemento code indica a cadeia de caracteres do código de erro do serviço de armazenagem, enquanto o elemento message indica a cadeia de caracteres da mensagem de erro.

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

Para a versão 29/07/2017 e posteriores, as operações de API com falha também retornam a cadeia de caracteres de código de erro de armazenamento em um header de resposta.

Cabeçalho de Resposta Descrição
x-ms-error-code Um valor que indica a cadeia de caracteres de código de erro do serviço de armazenamento.

Uma resposta de erro específica também pode incluir informações de erro adicionais para fornecer ao desenvolvedor mais informações sobre o erro. Por exemplo, a seguinte resposta de erro indica que um parâmetro de consulta especificado no URI de solicitação não era válido e fornece informações adicionais sobre o nome e o valor do parâmetro inválido e o motivo do erro.

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

Os tópicos a seguir fornecem listas de códigos de erro para os serviços Blob, Fila, Tabela e Arquivo:

Respostas de erro para o Serviço da Tabela

As respostas de erro para o serviço Tabela incluem o código de erro dos serviços de armazenamento e os elementos de mensagem, conforme mostrado acima, mas também estão em conformidade com o formato de erro descrito na seção 19 da especificação OData. Informações de erro adicionais podem ser incluídas em resposta além do código e mensagem de erro de serviços de armazenamento, mas a resposta de erro sempre será compatível como a especificação de OData.

As respostas de erro do lote são semelhantes às respostas de erro padrão do serviço Tabela e são descritas em detalhes em Executando transações de grupo de entidades.

Observação

JSON é o formato de carga recomendado para operações de serviço tabela e é o único formato com suporte para versões 2015-12-11 e posteriores.

Corpo de erro básico no formato JSON (versões 2013-08-15 e posterior)

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

Corpo do erro básico no formato Atom (versões anteriores a 12/12/2015)

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

Consulte Também

Solução de problemas de operações de API
Enumeração HttpStatusCode
Armazenamento REST de serviços