Verstehen von vorübergehenden Fehlern

  • 3 Minuten

In diesem Abschnitt diagnostizieren und behandeln wir Ausnahmen, die auftreten, weil der Azure Cosmos DB-Dienst nicht verfügbar ist. Diese Ausnahme kann normalerweise ermittelt werden, wenn die Anforderung den Statuscode 503 zurückgibt. Dieser bedeutet, dass die Vorgänge nicht abgeschlossen werden konnten, da der Dienst nicht verfügbar war. Es gibt mehrere Gründe, warum diese Ausnahme ausgelöst werden kann. Der Statuscode kann aufgrund von Problemen mit der Netzwerkkonnektivität oder Dienstverfügbarkeit zurückgegeben werden. In den meisten Fällen kann der Vorgang problemlos wiederholt werden, weil das Problem inzwischen möglicherweise behoben wurde. Wenn das Problem bestehen bleibt, müssen Sie sich an den Azure-Support wenden. Im Folgenden werden die drei Hauptfälle behandelt, bei denen dieser Statuscode zurückgegeben wird.

Erforderliche Ports werden blockiert

Überprüfen Sie, ob die folgenden Ports für die SQL-API freigegeben sind.

Verbindungsmodus Unterstütztes Protokoll Unterstützte SDKs API/Dienstport
Gateway HTTPS Alle SDKs SQL (443)
Direkt TCP .NET SDK, Java SDK Bei Verwendung öffentlicher Endpunkte/Dienstendpunkte: Ports im Bereich von 10000 bis 20000. Bei Verwendung von privaten Endpunkten: Ports im Bereich zwischen 0 und 65535

Clientseitige vorübergehende Konnektivitätsprobleme

Diese Ausnahme kann auftreten, wenn vorübergehende Konnektivitätsprobleme auftreten, die Timeouts verursachen. Die Stapelüberwachung für dieses Szenario enthält einen TransportException-Fehler. Dieser Fehler kann wie folgt aussehen:

TransportException: A client transport error occurred: The request timed out while waiting for a server response. 
(Time: xxx, activity ID: xxx, error code: ReceiveTimeout [0x0010], base error: HRESULT 0x80131500

Die Problembehandlung dieses Fehlers sollte wie bei einem Anforderungstimeoutfehler (Statuscode 408) erfolgen.

Dienstunterbrechung

Überprüfen Sie auf der Seite für den Azure-Status, ob derzeit ein andauerndes Problem vorliegt.