Condividi tramite

Codici di stato e di errore

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

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

Il corpo della risposta di errore segue il formato di base illustrato di seguito. L'elemento code indica la stringa del 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 della risposta Descrizione
x-ms-error-code Valore che indica la stringa del codice di errore.

Una particolare risposta di errore può anche includere informazioni dettagliate sull'errore per fornire allo sviluppatore ulteriori informazioni. Ad esempio, la risposta di errore seguente indica un parametro di query non valido specificato nell'URI della richiesta 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 all'errore includerà informazioni dettagliate 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 firmata 'o' è 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>

Nell'elenco di articoli seguente vengono fornite raccolte di codici di errore che potrebbero essere utili:

Copia risposta di errore API

La risposta di errore per le API di copia segue lo stesso formato indicato in precedenza. Il corpo della risposta di errore contiene l'elemento code per la stringa del codice di errore e l'elemento message che indica la stringa del messaggio di errore.

Per le versioni 2024-02-04 e successive, la risposta all'errore potrebbe includere un errore dettagliato se l'operazione di copia non riesce a causa di un problema con l'origine della copia, a condizione che l'errore dall'origine restituisca queste informazioni. La risposta può includere CopySourceStatusCode l'indicazione del codice di stato dell'operazione di copia dell'origine, CopySourceErrorCode la specifica di ciò che è x-ms-error-code stato restituito nella risposta di errore dell'origine di copia e CopySourceErrorMessage l'indicazione del messaggio di errore corrispondente.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>CannotVerifyCopySource</Code>  
  <Message> The specified blob doesn’t exist.
      RequestId:de1e2279-b01e-0000-5f26-5c4741000000
      Time:2023-03-21T18:52:10.1018932Z</Message>
  <CopySourceStatusCode> 404 </CopySourceStatusCode>
  <CopySourceErrorCode> BlobNotFound </CopySourceErrorCode>
  <CopySourceErrorMessage> The specified blob doesn’t exist </CopySourceErrorMessage> 
</Error>

Per le versioni 2024-02-04 e successive, Archiviazione di Azure restituisce il codice di stato dell'origine di copia e il codice di errore nell'intestazione della risposta, se vengono ricevuti nell'errore dell'origine di copia.

Intestazione della risposta Descrizione
x-ms-copy-source-status-code Valore che indica il codice di stato dell'errore dell'origine di copia.
x-ms-copy-source-error-code Valore che indica la stringa del codice di errore restituita dall'errore dell'origine di copia.

Le seguenti API di copia restituiscono questi dettagli:

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. Potrebbero essere incluse informazioni dettagliate sull'errore, ma la risposta all'errore è sempre conforme alle OData specifiche.

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

Annotazioni

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

L'esempio seguente mostra 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"}}}

L'esempio seguente mostra il corpo dell'errore di base in formato Atom (versioni 2015-12-11 e precedenti):

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

Vedere anche

Risoluzione dei problemi relativi alle operazioni API
Enumerazione HttpStatusCode
Servizi di stoccaggio REST