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 door de service is gedefinieerd. 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 2017-07-29 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 bepaalde foutreactie kan ook aanvullende foutinformatie bevatten om de ontwikkelaar meer informatie te geven. De volgende foutreactie geeft bijvoorbeeld aan dat een queryparameter die is opgegeven op de aanvraag-URI ongeldig is 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 lijsten met foutcodes die u mogelijk nuttig vindt:

• Algemene REST API-foutcodes

• Blob Storage-foutcodes

• Queue Storage-foutcodes

• Table Storage-foutcodes

• foutcodes Azure Files

Foutreacties voor Table Storage

Foutreacties voor Table Storage voldoen aan de foutindeling die wordt beschreven in sectie 19 van de OData-specificatie. Aanvullende foutinformatie kan 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 hoofdtekst van de basisfout 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 hoofdtekst van de basisfout in Atom-indeling (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
REST voor opslagservices