Condividi tramite


Codici di stato e errore

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>  

Per la versione 2024-08-04 e successive, la risposta di errore includerà informazioni aggiuntive sull'errore quando il tipo di risorsa firmata della firma di accesso condiviso dell'account non corrisponde alla risorsa a cui si accede. Ad esempio, la risposta di errore seguente indica che il tipo di risorsa 'o' firmato è necessario per eseguire l'operazione.

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

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