Delen via


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 tekenreeks voor de Azure Storage-foutcode in een antwoordheader.

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

Een bepaalde foutreactie kan ook aanvullende foutinformatie bevatten om de ontwikkelaar van meer informatie te voorzien. Het volgende foutantwoord geeft bijvoorbeeld aan dat een queryparameter die is opgegeven op de aanvraag-URI ongeldig is en biedt 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>  

Voor versie 2024-08-04 en hoger bevat het foutbericht aanvullende foutinformatie wanneer het ondertekende resourcetype van account-SAS niet overeenkomt met de resource die wordt geopend. Het volgende foutbericht geeft bijvoorbeeld aan dat het ondertekende resourcetype 'o' is vereist om de bewerking uit te voeren.

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

De volgende onderwerpen bevatten lijsten met foutcodes die u mogelijk nuttig vindt:

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