Freigeben über

Status- und Fehlercodes

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

API-Vorgänge können auch detaillierte Fehlerinformationen zurückgeben, die der Dienst definiert. Diese Fehlerinformationen werden im Antworttext zurückgegeben.

Der Text der Fehlerantwort folgt dem hier gezeigten Grundformat. 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>

Für Version 2017-07-29 und höher geben fehlgeschlagene API-Vorgänge auch die Azure Storage-Fehlercodezeichenfolge in einem Antwortheader zurück.

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

Eine bestimmte Fehlerantwort kann auch detaillierte Fehlerinformationen enthalten, um dem Entwickler weitere Informationen zur Verfügung zu stellen. Die folgende Fehlerantwort gibt z. B. einen ungültigen Abfrageparameter an, der im Anforderungs-URI angegeben ist, und enthält zusätzliche Informationen über den Namen und den Wert des ungültigen Parameters sowie den Grund für den Fehler.

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

Für Version 2024-08-04 und höher enthält die Fehlerantwort detaillierte Fehlerinformationen, wenn der signierte Ressourcentyp von Konto SAS nicht mit der Ressource übereinstimmt, auf die zugegriffen wird. Die folgende Fehlerantwort gibt z. B. 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 folgende Liste von Artikeln enthält Sammlungen von Fehlercodes, die für Sie nützlich sein können:

API-Fehlerantwort kopieren

Die Fehlerantwort für die Kopier-APIs folgt dem gleichen Format wie zuvor erwähnt. Der Text der Fehlerantwort enthält das code Element für die Fehlercodezeichenfolge und das Element, das message die Fehlermeldungszeichenfolge angibt.

Für die Versionen 2024-02-04 und höher kann die Fehlerantwort einen detaillierten Fehler enthalten, wenn der Kopiervorgang aufgrund eines Problems mit der Kopierquelle fehlschlägt, vorausgesetzt, der Fehler von der Quelle gibt diese Informationen zurück. Die Antwort kann die Angabe des Statuscodes des Kopierquellenvorgangs, die Angabe x-ms-error-code des in der Fehlerantwort der Kopierquelle zurückgegebenen Codes und CopySourceErrorMessage die Angabe der entsprechenden Fehlermeldung umfassenCopySourceStatusCode. CopySourceErrorCode

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

Für die Versionen 2024-02-04 und höher gibt Azure Storage den Statuscode und den Fehlercode für den Kopierquelltext im Antwortheader zurück, wenn sie im Fehler beim Kopieren der Quelle empfangen werden.

Antwortkopfzeile BESCHREIBUNG
x-ms-copy-source-status-code Ein Wert, der den Statuscode des Fehlers beim Kopieren der Quelle angibt.
x-ms-copy-source-error-code Ein Wert, der die Fehlercodezeichenfolge angibt, die vom Fehler beim Kopieren der Quelle zurückgegeben wurde.

Die folgenden Kopier-APIs geben die folgenden Details zurück:

Fehlerantworten für Table Storage

Fehlerantworten für Table Storage entsprechen dem Fehlerformat, das in Abschnitt 19 der OData-Spezifikation beschrieben ist. Detaillierte Fehlerinformationen können enthalten sein, aber die Fehlerantwort entspricht immer der OData Spezifikation.

Batch-Fehlerantworten ähneln standardmäßigen Table Storage-Fehlerantworten. Weitere Informationen finden Sie unter Ausführen von Entitätsgruppentransaktionen.

Hinweis

JSON ist das empfohlene Nutzlastformat für Table Storage. Es ist das einzige Format, das für Version 2015-12-11 und höher unterstützt wird.

Das folgende Beispiel zeigt den grundlegenden Fehlertext im JSON-Format (Version 2013-08-15 und höher):

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

Das folgende Beispiel zeigt den grundlegenden Fehlertext im Atom-Format (Versionen 2015-12-11 und früher):

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

Siehe auch

Fehlerbehebung bei API-Vorgängen
HttpStatusCode-Enumeration
REST für Speicherdienste