Status e códigos de erro
As operações de API REST para o 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 de API também podem retornar informações de erro adicionais definidas pelo serviço. 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 code
elemento indica a cadeia de caracteres de código de erro, enquanto o message
elemento indica a cadeia de caracteres de mensagem de erro.
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>string-value</Code>
<Message>string-value</Message>
</Error>
Para a versão 2017-07-29 e posterior, as operações de API com falha também retornam a cadeia de caracteres de código de erro do Armazenamento do Azure em um cabeçalho 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. |
Uma resposta de erro específica também pode incluir informações de erro adicionais para fornecer ao desenvolvedor mais informações. Por exemplo, a resposta de erro a seguir indica que um parâmetro de consulta especificado no URI de solicitação é invá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 que você pode achar úteis:
Respostas de erro para o Armazenamento de Tabelas
As respostas de erro do Armazenamento de Tabelas 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, mas a resposta de erro sempre está em conformidade com a OData
especificação.
As respostas de erro em lote são semelhantes às respostas de erro padrão do Armazenamento de Tabelas. Para obter mais informações, confira Executar transações de grupo de entidades.
Observação
JSON é o formato de carga recomendado para o Armazenamento de Tabelas. É o único formato com suporte para a versão 2015-12-11 e posterior.
A seguir mostra o corpo do erro básico no formato JSON (versão 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"}}}
A seguir, mostra o corpo do erro básico no formato Atom (versões anteriores a 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>
Confira também
Solução de problemas de operações de API
Enumeração HttpStatusCode
REST dos serviços de armazenamento