Codici di stato e errore

  • Articolo

Le operazioni dell'API REST per Archiviazione di Azure restituiscono codici di stato HTTP standard, come definito nelle definizioni di codice di stato HTTP/1.1.

Le operazioni API possono anche restituire informazioni aggiuntive sugli errori definite dal servizio. Queste informazioni aggiuntive sugli errori vengono restituite nel corpo della risposta.

Di seguito viene indicato il formato base del corpo della risposta di errore. L'elemento code indica la stringa di codice di errore, mentre l'elemento message indica la stringa del messaggio di errore.

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

Per la versione 2017-07-29 e successive, le operazioni API non riuscite restituiscono anche la stringa del codice di errore di Archiviazione di Azure in un'intestazione di risposta.

Intestazione risposta Descrizione
x-ms-error-code Valore che indica la stringa di codice di errore.

Una particolare risposta di errore potrebbe includere anche informazioni aggiuntive sugli errori per fornire allo sviluppatore altre informazioni. Ad esempio, la risposta di errore seguente indica che un parametro di query specificato nell'URI della richiesta non è valido e fornisce informazioni aggiuntive sul nome e sul valore del parametro non valido e sul motivo dell'errore.

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

Gli argomenti seguenti forniscono elenchi di codici di errore che potrebbero risultare utili:

Risposte di errore per l'archiviazione tabelle

Le risposte di errore per l'archiviazione tabelle sono conformi al formato di errore descritto nella sezione 19 della specifica OData. È possibile includere informazioni aggiuntive sull'errore, ma la risposta di errore è sempre conforme alla OData specifica.

Le risposte di errore batch sono simili alle risposte di errore standard di archiviazione tabelle. Per altre informazioni, vedere la sezione Esecuzione di transazioni di gruppi di entità.

Nota

JSON è il formato di payload consigliato per l'archiviazione tabelle. È l'unico formato supportato per la versione 2015-12-11 e successive.

Di seguito viene illustrato il corpo dell'errore di base in formato JSON (versione 2013-08-15 e successive):

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

Di seguito viene illustrato il corpo dell'errore di base in formato Atom (versioni precedenti alla versione 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>

Vedi anche

Risoluzione dei problemi relativi alle operazioni api
Enumerazione HttpStatusCode
REST dei servizi di archiviazione