Freigeben über

HTTP-Statuscodes für Azure Cosmos DB

  • Artikel

Dieser Artikel enthält die HTTP-Statuscodes, die von den REST-Vorgängen zurückgegeben werden.

Code Beschreibung
200 OK Einer der folgenden REST-Vorgänge war erfolgreich:

- GET für eine Ressource.
- PUT für eine Ressource.
- POST für eine Ressource.
- POST in einer gespeicherten Prozedurressource, um die gespeicherte Prozedur auszuführen.
201 – Erstellt Ein POST-Vorgang zum Erstellen einer Ressource war erfolgreich.
204 Kein Inhalt Der DELETE-Vorgang wurde erfolgreich ausgeführt.
400 Ungültige Anforderung Der JSON-, SQL- oder JavaScript-Abschnitt im Textteil der Anforderung ist ungültig.

Darüber hinaus kann "400 Bad Request" auch zurückgegeben werden, wenn die erforderlichen Eigenschaften einer Ressource nicht vorhanden sind oder im Nachrichtentext einer POST- oder PUT-Anforderung für die Ressource nicht festgelegt wurden.

"400 Bad Request" wird auch zurückgegeben, wenn die konsistente Ebene für einen GET-Vorgang mit stärkerer Konsistenz als für das Konto festgelegt außer Kraft gesetzt wird.

400 wird auch zurückgegeben, wenn eine Anforderung, die einen x-ms-documentdb-partitionkey erfordert, sie nicht enthält.
401 – Nicht autorisiert 401 wird zurückgegeben, wenn der Authorization Header für die angeforderte Ressource ungültig ist.
403 – Unzulässig Das Autorisierungstoken ist abgelaufen.

403-Code wird auch während eines Vorgangs POST zum Erstellen einer Ressource zurückgegeben, wenn das Ressourcenkontingent erreicht wurde. Ein Beispiel für dieses Szenario ist das Hinzufügen von Dokumenten zu einer Sammlung, die ihren bereitgestellten Speicher erreicht hat.

403 kann auch zurückgegeben werden, wenn eine gespeicherte Prozedur, ein Trigger oder eine benutzerdefinierte Funktion aufgrund einer hohen Ressourcenauslastung markiert wurde und die Ausführung blockiert wird.

Der Fehler „403 – Unzulässig“ wird zurückgegeben, wenn die Firewallregeln, die für Ihr Azure Cosmos DB-Konto konfiguriert wurden, Ihre Anforderung blockieren. Alle Anforderungen, die von Computern außerhalb der zulässigen Liste stammen, erhalten eine 403-Antwort.

403.3 – Dieser status Code wird während des manuellen Failovervorgangs für Schreibanforderungen zurückgegeben. Dieser status Code wird von Treibern als Umleitungscode verwendet, um die Schreibanforderungen an einen neuen Schreibbereich weiterzuleiten. Der Client für direkte REST-Aufrufe muss einen GET-Vorgang für „DatabaseAccount“ durchführen, um die aktuelle Schreibregion zu identifizieren und die Schreibanforderung an diesen Endpunkt weiterzuleiten.
404 – Nicht gefunden Es wird versucht, eine nicht mehr vorhandene Ressource zu verarbeiten. Beispiel: Die Ressource wurde möglicherweise bereits gelöscht.
408: Anforderungstimeout Der Vorgang wurde nicht innerhalb der vorgesehenen Zeit abgeschlossen. Dieser Code wird zurückgegeben, wenn eine gespeicherte Prozedur, ein Trigger oder eine benutzerdefinierte Funktion (innerhalb einer Abfrage) nicht innerhalb der maximalen Ausführungszeit abgeschlossen wird.
409 – Konflikt Die für eine Ressource in einer PUT- oder POST-Operation bereitgestellte ID wurde von einer vorhandenen Ressource übernommen. Verwenden Sie eine andere ID für die Ressource, um dieses Problem zu beheben. Bei partitionierten Sammlungen muss die ID in allen Dokumenten mit demselben Partitionsschlüsselwert eindeutig sein.
412 Vorbedingungsfehler In der Operation wurde ein eTag festgelegt, das sich von der auf dem Server verfügbaren Version unterscheidet, d.h., es liegt ein Fehler bei vollständiger Parallelität vor. Wiederholen Sie die Anforderung nach dem Lesen der neuesten Version der Ressource und dem Aktualisieren des eTag für die Anforderung.
413 Entität zu groß Die Dokumentgröße in der Anforderung hat die zulässige Dokumentgröße für eine Anforderung überschritten. Die maximale zulässige Dokumentgröße beträgt 2 MB.
423 Gesperrt Der Vorgang zur Durchsatzskalierung kann nicht ausgeführt werden, da gerade ein anderer Skalierungsvorgang ausgeführt wird.
424 Fehlgeschlagene Abhängigkeit Wenn bei einem Dokumentvorgang innerhalb des Transaktionsbereichs eines TransactionalBatch-Vorgangs ein Fehler auftritt, werden alle anderen Vorgänge innerhalb des Batches als fehlgeschlagene Abhängigkeiten betrachtet. Dieser Statuscode zeigt an, dass der aktuelle Vorgang aufgrund eines anderen Fehlers innerhalb desselben Transaktionsbereichs als fehlerhaft betrachtet wurde.
429 Zu viele Anforderungen Für die Sammlung wurde der Grenzwert für den bereitgestellten Durchsatz überschritten. Wiederholen Sie die Anforderung, nachdem vom Server der entsprechende Zeitpunkt für die Wiederholung angegeben wurde. Weitere Informationen finden Sie unter Anforderungseinheiten.
449: Wiederholung mit Beim Vorgang ist ein vorübergehender Fehler aufgetreten. Dieser Code tritt nur bei Schreibvorgängen auf. Es ist sicher, den Vorgang erneut auszuführen.
500 – Interner Serverfehler Der Vorgang war aufgrund eines unerwarteten Dienstfehlers fehlerhaft. Wenden Sie sich an den Support. Weitere Informationen finden Sie unter Einreichen eines Azure-Support Problems.
503 – Dienst nicht verfügbar Der Vorgang konnte nicht abgeschlossen werden, da der Dienst nicht verfügbar war. Diese Situation kann aufgrund von Netzwerkkonnektivität oder Dienstverfügbarkeitsproblemen auftreten. Es ist sicher, den Vorgang erneut auszuführen. Wenden Sie sich an den Support, wenn das Problem weiterhin besteht.

HTTP-Unterstatuscodes

Wenn Customer-Managed Keys (CMK) in Azure Cosmos DB verwendet wird, gibt Azure Cosmos DB die Fehlerdetails zusammen mit einem HTTP-Unterstatuscode in der Antwort zurück. Sie können diesen Unterstatuscode verwenden, um die Grundursache des Problems zu debuggen. Derzeit unterstützt Azure Cosmos DB die folgenden Unterstatuscodes:

Unterstatuscodes für serverseitige Probleme

Die folgenden Unterstatuscodes werden von Azure Cosmos DB für serverseitige Probleme unterstützt:

Unterstatuscode Beschreibung
4000 (Fehler beim Abrufen/Zugreifen auf das Azure AD-Token) Dieser Fehler tritt auf, wenn Azure Cosmos DB das Azure Active Directory-Zugriffstoken (Azure AD) nicht abrufen kann. Dieses Token ist erforderlich, damit Azure Cosmos DB auf die Key Vault zugreifen kann. Der Fehler kann aufgrund eines Netzwerkproblems oder eines Rechenzentrumsproblems auftreten, und der Benutzer kann keine Aktion ausführen. Erstellen Sie eine Supportanfrage , um das Azure Cosmos DB-Team zu erreichen, um das Problem zu beheben.
4001 (Azure AD-Dienst ist nicht verfügbar) Dieser Fehler tritt auf, wenn der Azure AD-Dienst ausgefallen ist oder Probleme hat. Sie können den Azure-Ausfall Dashboard überprüfen, um zu überprüfen, ob ein Ausfall vorliegt. Diese Ausfälle werden in der Regel innerhalb weniger Stunden behoben. Am besten können Sie sich an das Azure AD-Team wenden und es über das angezeigte Problem informieren. Wenn das Azure AD-Team feststellt, dass kein Problem vorliegt, erstellen Sie eine Supportanfrage , um das Azure Cosmos DB-Team zur Lösung zu erreichen.
4004 (Key Vault Dienst ist nicht verfügbar) Dieser Fehler tritt auf, wenn Azure Cosmos DB versucht, auf die Key Vault zuzugreifen, der Dienst jedoch nicht verfügbar ist. Dies kann darauf zurückzuführen sein, dass ein Netzwerkproblem Key Vault erreicht oder der Dienst selbst ausgefallen ist. Sie können den Azure-Ausfall Dashboard überprüfen, um zu überprüfen, ob ein Ausfall vorliegt. Diese Ausfälle werden in der Regel innerhalb weniger Stunden behoben. Es ist am besten, wenn Sie sich an das Key Vault-Team wenden und es über das Angezeigte Problem informieren können. Wenn das Key Vault-Team feststellt, dass kein Problem vorliegt, erstellen Sie eine Supportanfrage, um das Azure Cosmos DB-Team zur Lösung zu erreichen.
4007 (Interner Serverfehler) Dies ist ein interner Serverfehler, der auftritt, wenn die Eingabebytes nicht im Base64-Format vorliegen.
4008 (Key Vault interne Dienstfehler) Dieser Fehler tritt auf, wenn Azure Cosmos DB nicht auf die Key Vault zugreifen kann. Dies kann auf ein Netzwerkproblem zurückzuführen sein oder wenn der Key Vault Dienst selbst ausgefallen ist. Sie können den Azure-Ausfall Dashboard überprüfen, um zu überprüfen, ob ein Ausfall vorliegt. Diese Ausfälle werden in der Regel innerhalb weniger Stunden behoben. Es ist am besten, wenn Sie sich an das Key Vault-Team wenden und es über das Angezeigte Problem informieren können. Wenn das Key Vault-Team feststellt, dass kein Problem vorliegt, wenden Sie sich zur Lösung an das Azure Cosmos DB-Team.
1013 (Vorgang zum Erstellen der Sammlung wird ausgeführt) Wenn eine Timeoutausnahme zurückgegeben wird, wenn eine Sammlung erstellt wird, führen Sie einen Lesevorgang aus, um zu überprüfen, ob die Sammlung erfolgreich erstellt wurde. Der Lesevorgang gibt eine Ausnahme zurück, bis der Vorgang zum Erstellen der Sammlung erfolgreich war. Wenn der Lesevorgang eine Ausnahme mit status Code 404 und unter status Code 1013 auslöst, bedeutet dies, dass der Vorgang zum Erstellen der Sammlung noch ausgeführt wird. Wiederholen Sie den Lesevorgang, bis Sie 200- oder 201-status-Codes erhalten. Diese Codes informieren Sie darüber, dass die Sammlung erfolgreich erstellt wurde.

Unterstatuscodes für Endbenutzerprobleme

Die folgenden Unterstatuscodes werden von Azure Cosmos DB für Probleme unterstützt, die vom Endbenutzer verursacht werden:

Unterstatuscode Beschreibung
4002 (Key Vault erteilt Azure AD keine Berechtigung, oder der Schlüssel ist deaktiviert) Dieses Problem tritt auf, wenn Sie die Azure Cosmos DB-Identität aus der Key Vault Zugriffsrichtlinien entfernt haben oder wenn Sie den Schlüssel deaktiviert haben. Dieses Problem wird in der Regel vom Endbenutzer verursacht. Wenn dieser Fehler auftritt, stellen Sie sicher, dass Azure Cosmos DB Zugriff auf die Key Vault hat und der Schlüssel aktiviert ist.
4003 (Schlüssel wurde nicht gefunden) Dieses Problem tritt auf, wenn der Schlüssel aus dem Key Vault gelöscht wird. Dieses Problem wird in der Regel vom Endbenutzer verursacht. Eine der Voraussetzungen für die Verwendung von Azure Cosmos DB mit kundenseitig verwalteten Schlüsseln besteht darin, dass für die Key Vault vorläufiges Löschen und Löschen des Schutzes aktiviert ist. Dies bedeutet, dass Sie den gelöschten Schlüssel wiederherstellen und den Zugriff auf Azure Cosmos DB wiederherstellen können.
4005 (Der Schlüssel kann nicht um- oder entpackt werden) Dieser Fehler tritt auf, wenn der Key Vault den Schlüssel nicht umschließen oder entpacken kann. Dieses Problem wird in der Regel vom Endbenutzer verursacht. Eine der möglichen Ursachen für diesen Fehler ist, dass der Key Vault das verschlüsselte Blob nicht mithilfe des neuesten Schlüssels decodieren konnte, da Sie den Schlüssel gedreht haben. Um diesen Fehler zu beheben, aktivieren Sie alle zuletzt deaktivierten Schlüssel, die in etwa einer Stunde aufgelöst werden. Wenn das Problem nach mehr als 2 Stunden nicht behoben ist, übergeben Sie das Problem an Azure Cosmos DB.
4006 (Schlüssel-URL ist ungültig) Dieser Fehler tritt während der Bereitstellung auf, wenn Sie die Schlüsselversion in die Key Vault-URL eingefügt haben. Dieser Fehler wird häufig vom Endbenutzer verursacht. Um diesen Fehler zu beheben, entfernen Sie die Version, und versuchen Sie es erneut. Wenn Sie beispielsweise die URL im Format https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/<KeyVersion>verwendet haben, aktualisieren Sie sie auf https://<KeyVaultName>.vault.azure.net/keys/<KeyName>/
4009 (Key Vault DNS-Name kann nicht aufgelöst werden) Dieser Fehler tritt auf, wenn der Key Vault DNS-Name nicht aufgelöst werden konnte, da Sie den falschen Key Vault Namen verwendet haben. Dieser Fehler wird vom Endbenutzer verursacht. Korrigieren Sie zum Auflösen den namen Key Vault, und versuchen Sie es erneut.

Weitere Informationen