Status en foutcodes

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

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

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

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

Voor versie 29-07-2017 en hoger retourneren mislukte API-bewerkingen ook de azure Storage-foutcodetekenreeks in een antwoordheader.

Antwoordheader	Beschrijving
x-ms-error-code	Een waarde die de foutcodetekenreeks aangeeft.

Een bepaald foutantwoord kan ook aanvullende foutinformatie bevatten om de ontwikkelaar meer informatie te geven. Het volgende foutbericht geeft bijvoorbeeld aan dat een queryparameter die is opgegeven in de aanvraag-URI ongeldig is en bevat aanvullende informatie 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 lijsten met foutcodes die u mogelijk nuttig vindt:

• Veelvoorkomende REST API-foutcodes

• Blob Storage-foutcodes

• Queue Storage-foutcodes

• Table Storage-foutcodes

• Azure Files foutcodes

Foutreacties voor Table Storage

Foutreacties voor Table Storage voldoen aan de foutindeling die wordt beschreven in sectie 19 van de OData-specificatie. Er kunnen aanvullende foutinformatie worden opgenomen, maar de foutreactie voldoet altijd aan de OData specificatie.

Batchfoutreacties zijn vergelijkbaar met standaardantwoorden voor Table Storage-fouten. Zie Entiteitsgroepstransacties uitvoeren voor meer informatie.

Notitie

JSON is de aanbevolen nettoladingindeling voor Table Storage. Dit is de enige indeling die wordt ondersteund voor versie 2015-12-11 en hoger.

Hieronder ziet u de basisfouttekst in JSON-indeling (versie 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"}}}  
  

Hieronder ziet u de basisfouttekst in Atom-indeling (versies vóór 11-12-2015):

<?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
Rest voor opslagservices