Compartilhar via


Status e códigos de erro

As operações da 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 da 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>  

Para a versão 2024-08-04 e posterior, a resposta de erro incluirá informações de erro adicionais quando o tipo de recurso assinado da SAS da conta não corresponder ao recurso que está sendo acessado. Por exemplo, a resposta de erro a seguir indica que o tipo de recurso assinado 'o' é necessário para executar a operaçã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>

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 adicionais de erro 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 conteúdo recomendado para o Armazenamento de Tabelas. É o único formato com suporte para a versão 2015-12-11 e posterior.

Veja a seguir 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"}}}  
  

Veja a seguir 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