Delen via

Status en foutcodes

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

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

De hoofdtekst van de foutmelding volgt de basisindeling die hier wordt weergegeven. Het code element geeft de foutcodereeks aan, terwijl het message element de foutberichtreeks 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 foutcodereeks aangeeft.

Een bepaalde foutreactie kan ook gedetailleerde foutinformatie bevatten om de ontwikkelaar meer informatie te geven. Het volgende foutantwoord geeft bijvoorbeeld een ongeldige queryparameter aan die is opgegeven in de aanvraag-URI 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 de foutreactie gedetailleerde foutinformatie wanneer het ondertekende resourcetype van Account SAS niet overeenkomt met de resource die wordt geopend. Het volgende foutantwoord geeft bijvoorbeeld aan dat het ondertekende resourcetype 'o' vereist is 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 lijst met artikelen bevat verzamelingen foutcodes die u mogelijk nuttig vindt:

Kopieer API-foutreactie

Het foutantwoord voor de Copy API's volgt hetzelfde formaat als eerder vermeld. De hoofdtekst van het foutantwoord bevat het code element voor de foutcodereeks en het message element dat de foutberichtreeks aangeeft.

Voor versies 2024-02-04 en hoger kan het foutantwoord een gedetailleerde fout bevatten als de kopieerbewerking mislukt vanwege een probleem met de kopieerbron, op voorwaarde dat de fout van de bron deze informatie retourneert. Het antwoord kan bestaan uit CopySourceStatusCode het aangeven van de statuscode van de bewerking van de kopieerbron, CopySourceErrorCode het specificeren van het x-ms-error-code geretourneerde in het foutantwoord van de kopieerbron en CopySourceErrorMessage het aangeven van het bijbehorende foutbericht.

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

Voor versies 2024-02-04 en hoger retourneert Azure Storage de statuscode van de kopieerbron en de foutcode in de antwoordkop, als deze worden ontvangen in de fout met de kopieerbron.

Antwoordheader Beschrijving
x-ms-copy-source-status-code Een waarde die de statuscode van de fout in de kopieerbron aangeeft.
x-ms-copy-source-error-code Een waarde die de foutcodetekenreeks aangeeft die wordt geretourneerd door de fout in de kopieerbron.

De volgende kopieer-API's retourneren deze gegevens:

Foutreacties voor tabelopslag

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

Batchfoutreacties zijn vergelijkbaar met standaardfoutreacties op Table Storage. Zie Entiteitsgroeptransacties uitvoeren voor meer informatie.

Opmerking

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

In het volgende voorbeeld ziet u de basisfoutbody 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"}}}

In het volgende voorbeeld ziet u de basisfouttekst in Atom-indeling (versies 2015-12-11 en eerder):

<?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 van HttpStatusCode
Opslagdiensten REST

  • Last updated on