Status- und Fehlercodes
REST-API-Vorgänge für Azure Storage geben standardmäßige HTTP-Statuscodes 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>
Ab Version 2024-08-04 enthält die Fehlerantwort zusätzliche Fehlerinformationen, wenn der signierte Ressourcentyp der Konto-SAS nicht mit der Ressource übereinstimmt, auf die zugegriffen wird. Die folgende Fehlerantwort gibt beispielsweise an, dass der signierte Ressourcentyp "o" zum Ausführen des Vorgangs erforderlich ist.
<?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>
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