Status- und Fehlercodes

  • Artikel

REST-API-Vorgänge für Azure Storage geben standardmäßige HTTP-status-Codes zurück, die in den HTTP/1.1-Statuscodedefinitionen definiert sind.

API-Vorgänge können auch zusätzliche Fehlerinformationen zurückgeben, die vom Dienst definiert werden. Diese zusätzlichen Fehlerinformationen werden im Antworttext zurückgegeben.

Der Text der Fehlerantwort weist das folgende allgemeine Format auf: Das code -Element gibt die Fehlercodezeichenfolge an, während das message -Element die Fehlermeldungszeichenfolge angibt.

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

Ab Version 2017-07-29 geben fehlgeschlagene API-Vorgänge auch die Azure Storage-Fehlercodezeichenfolge in einem Antwortheader zurück.

Antwortheader BESCHREIBUNG
x-ms-error-code Ein Wert, der die Fehlercodezeichenfolge angibt.

Eine bestimmte Fehlerantwort kann auch zusätzliche Fehlerinformationen enthalten, um dem Entwickler weitere Informationen zur Verfügung zu stellen. Die folgende Fehlerantwort gibt beispielsweise an, dass ein für den Anforderungs-URI angegebene Abfrageparameter ungültig ist, und stellt zusätzliche Informationen zum Namen und Wert des ungültigen Parameters sowie zum Grund für den Fehler bereit.

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

Die folgenden Themen enthalten Listen mit Fehlercodes, die Sie möglicherweise nützlich finden:

Fehlerantworten für Tabellenspeicher

Fehlerantworten für Table Storage entsprechen dem in Abschnitt 19 der OData-Spezifikation beschriebenen Fehlerformat. Möglicherweise sind zusätzliche Fehlerinformationen enthalten, aber die Fehlerantwort entspricht immer der OData Spezifikation.

Batchfehlerantworten ähneln den Standardmäßigen Tabellenspeicherfehlerantworten. Weitere Informationen finden Sie unter Durchführen von Entitätsgruppentransaktionen.

Hinweis

JSON ist das empfohlene Nutzlastformat für Tabellenspeicher. Es ist das einzige Format, das ab Version 2015-12-11 unterstützt wird.

Im Folgenden wird der grundlegende Fehlertext im JSON-Format (Version 2013-08-15 und höher) veranschaulicht:

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

Im Folgenden sehen Sie den grundlegenden Fehlertext im Atom-Format (Versionen vor 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>

Weitere Informationen

Problembehandlung bei API-Vorgängen
HttpStatusCode-Enumeration
Rest der Speicherdienste