Status e códigos de erroStatus and error codes

As operações de API REST para serviços de armazenamento Azure retornam códigos de status HTTP padrão, conforme definido nas Definições de Código de Status HTTP/1.1.REST API operations for Azure storage services return standard HTTP status codes, as defined in the HTTP/1.1 Status Code Definitions.

As operações da API também podem retornar informações de erro adicionais que são definidas pelo serviço de gerenciamento.API operations may also return additional error information that is defined by the storage service. Essas informações de erro adicionais são retornadas no corpo de resposta.This additional error information is returned in the response body.

O corpo da resposta de erro apresenta o formato básico mostrado a seguir.The body of the error response follows the basic format shown here. 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.The code element indicates the storage service error code string, whereas the message element indicates the error message string.

<?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 seqüência de código de erro de armazenamento em um cabeçalho de resposta.For version 2017-07-29 and later, failed API operations also return the storage error code string in a response header.

Cabeçalho de RespostaResponse Header DescriçãoDescription
x-ms-error-code Um valor que indica a seqüência de código de erro do serviço de armazenamento.A value that indicates the storage service error code string.

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.A given error response may also include additional error information to provide the developer with more information about the error. 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.For example, the following error response indicates that a query parameter specified on the request URI was invalid, and provides additional information about the invalid parameter's name and value and the reason for the error.

<?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:The following topics provide lists of error codes for the Blob, Queue, Table, and File services:

Respostas de erro para o Serviço da TabelaError Responses for the Table Service

As respostas de erro para o serviço Tabela incluem o código de erro dos serviços de armazenamento e os elementos da mensagem, como mostrado acima, mas também estão em conformidade com o formato de erro descrito na seção 19 da especificação OData.Error responses for the Table service include the storage services error code and message elements, as shown above, but are also compliant with the error format described in section 19 of the OData specification. 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.Additional error information may be included in the response in addition to the storage services error code and message, but the error response will always comply with the OData spec.

As respostas de erro em lote são semelhantes às respostas de erro de serviço de mesa padrão e são descritas detalhadamente no Performing Entity Group Transactions.Batch error responses are similar to standard Table service error responses and are described in detail in Performing Entity Group Transactions.

Observação

JSON é o formato de carga útil recomendado para operações de serviço de tabela, e é o único formato suportado para as versões 2015-12-11 e posteriores.JSON is the recommended payload format for Table service operations, and is the only format supported for versions 2015-12-11 and later.

Corpo de erro básico no formato JSON (versões 2013-08-15 e posteriores)Basic Error Body in JSON Format (versions 2013-08-15 and later)

{"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 de erro básico no formato Átomo (versões anteriores a 2015-12-11)Basic Error Body in Atom Format (versions prior to 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>  
  

Consulte TambémSee Also

Solucionando problemas em operações de API Troubleshooting API Operations
Enumeração httpstatuscode HttpStatusCode Enumeration
Serviços de armazenamento RESTStorage Services REST