Status en foutcodes

REST API-bewerkingen voor Azure Storage-services retourneren standaard HTTP-statuscodes, zoals gedefinieerd in de statuscodedefinities HTTP/1.1.

API-bewerkingen kunnen ook aanvullende foutinformatie retourneren die is gedefinieerd door de opslagservice. Deze aanvullende foutinformatie wordt geretourneerd in de hoofdtekst van het antwoord.

De hoofdtekst van het foutantwoord volgt de basisindeling die hier wordt weergegeven. Het code element geeft de foutcodetekenreeks van de opslagservice aan, terwijl het message element de tekenreeks voor het foutbericht aangeeft.

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

Voor versie 2017-07-29 en hoger retourneren mislukte API-bewerkingen ook de tekenreeks voor opslagfoutcode in een antwoordheader.

Reactieheader Beschrijving
x-ms-error-code Een waarde die de foutcodereeks voor de opslagservice aangeeft.

Een opgegeven foutreactie kan ook aanvullende foutinformatie bevatten om de ontwikkelaar meer informatie over de fout te geven. Het volgende foutbericht geeft bijvoorbeeld aan dat een queryparameter die is opgegeven op de aanvraag-URI ongeldig was en aanvullende informatie bevat over de naam en waarde van de ongeldige parameter en de reden voor de fout.

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

De volgende onderwerpen bevatten een lijst met foutcodes voor de services Blob, Queue, Table en File:

Foutreacties voor de tabelservice

Foutreacties voor de Table-service bevatten de foutcode en berichtelementen van de opslagservices, zoals hierboven wordt weergegeven, maar voldoen ook aan de foutindeling die wordt beschreven in sectie 19 van de OData-specificatie. Aanvullende foutinformatie kan worden opgenomen in het antwoord naast de foutcode en het bericht van de opslagservices, maar het foutbericht voldoet altijd aan de OData-specificatie.

Batchfoutreacties zijn vergelijkbaar met standaardantwoorden voor tabelservicefouten en worden gedetailleerd beschreven in het uitvoeren van entiteitsgroepstransacties.

Notitie

JSON is de aanbevolen payload-indeling voor Tabelservicebewerkingen en is de enige indeling die wordt ondersteund voor versies 2015-12-11 en hoger.

Basisfouttekst in JSON-indeling (versies 2013-08-15 en hoger)

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

Basisfouttekst in Atom Format (versies vóór 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>  
  

Zie ook

Problemen met API-bewerkingen oplossen
Opsomming httpStatusCode
Storage Services REST