HTTP-status-Codes (Azure AI Search)
Auf dieser Seite werden die HTTP-status Codes beschrieben, die häufig bei Verwendung der Azure AI Search-API zurückgegeben werden.
Allgemeine HTTP-Statuscodes
| Code | BESCHREIBUNG |
|---|---|
| 200 – OK | Erfolgreiche Ausführung von GET, PUT oder POST. Wird für eine erfolgreiche Antwort zurückgegeben. Während der Indizierung gibt dieser Code an, dass alle Elemente dauerhaft gespeichert wurden und beginnen, indiziert zu werden. Die Indizierung wird im Hintergrund ausgeführt und macht neue Dokumente ein paar Sekunden nach Abschluss des Indizierungsvorgangs abfragen und durchsuchbar. |
| 201 – Erstellt | Erfolgreiche Ausführung von PUT oder POST. Das Objekt wurde erfolgreich erstellt oder aktualisiert. |
| 204 Accepted | Erfolgreiche Ausführung von PUT oder POST. Index oder Dokumente wurden erfolgreich hochgeladen. |
| 207 Multi-Status | Teilweise erfolgreiche Ausführung von PUT oder POST. Einige Dokumente waren erfolgreich, aber bei mindestens einem Dokument ist ein Fehler aufgetreten. |
| 400 – Ungültige Anforderung | Wird zurückgegeben, wenn ein Fehler im Anforderungs-URI, in den Headern oder im Text der Anforderung vorliegt. Der Antworttext enthält eine Fehlermeldung, in der erläutert wird, was das spezifische Problem ist. |
| 403 Verboten | Dieser Code wird zurückgegeben, wenn Sie einen ungültigen API-Schlüssel übergeben. |
| 404 – Nicht gefunden | Wird zurückgegeben, wenn eine Ressource auf dem Server nicht vorhanden ist. Wenn Sie einen Index verwalten oder abfragen, überprüfen Sie die Syntax, und vergewissern Sie sich, dass der Indexname korrekt angegeben ist. |
| 405-Methode wird nicht unterstützt | Wird zurückgegeben, wenn die Anforderung eine Methode angibt, die erkannt, aber nicht unterstützt wird. Wenn Sie einen Index abfragen, umfasst die Formulierung dieser Anforderung den Endpunkt, die Indizesauflistung und den Index sowie die Docs-Auflistung und die Suchmethode (z. B https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30. ). |
| 409 – Konflikt | Wird zurückgegeben, wenn Schreibvorgänge in Konflikt geraten. Dieser Fehler wird bei Ressourcenupdates oder während der Indizierung zurückgegeben, wenn zwei Prozesse versuchen, dasselbe Dokument gleichzeitig zu aktualisieren. Azure KI Search bietet Parallelitätsverwaltung für Ressourcenupdates. Weitere Informationen finden Sie unter Verwalten der Parallelität in Azure AI Search. |
| 412 Precondition Failed | Wird zurückgegeben, wenn die Bedingung eines If-Match- oder If-None-Match-Headers als false ausgewertet wird. Verknüpft mit der Verwendung der Steuerung für optimistische Parallelität beim Senden von HTTP-Anforderungen für Indexdefinitionen, Indexer oder Datenquellen. |
| 429 – Zu viele Anforderungen | Wenn dieser Fehler auftritt, während Sie versuchen, einen Index zu erstellen, bedeutet dies, dass Sie bereits über die maximale Anzahl von Indizes verfügen, die für Ihren Tarif zulässig sind. Die Anzahl der in Azure AI Search gespeicherten Indizes wird im Suchdienst Dashboard auf der Azure-Portal angezeigt. Um die Indizes anhand des Namens anzuzeigen, wählen Sie die Kachel Index aus. Alternativ können Sie auch eine Liste der Indizes anhand des Namens abrufen, indem Sie den Vorgang Auflisten von Indizes verwenden . Details finden Sie unter Indizes auflisten .
Wenn dieser Fehler beim Hochladen von Dokumenten auftritt, bedeutet dies, dass Sie ihr Kontingent für die Anzahl der Dokumente pro Index überschritten haben. Erstellen Sie in diesem Fall entweder einen neuen Index oder aktualisieren Sie auf höhere Kapazitätsgrenzen. |
| 499: Geschlossene Clientanforderung | Dieser Fehler wird nie in einer Antwort zurückgegeben, aber möglicherweise wird er in Protokolleinträgen angezeigt, die von Suchdatenverkehrsanalysen und Azure Monitor aufgezeichnet wurden. Es gibt an, dass ein Client die Verbindung geschlossen hat, bevor vom Dienst eine Antwort zurückgegeben wurde. Wenn Azure AI Search einen Abbruch erkennt, der nicht vom dienstseitigen Code angefordert wurde oder dass der Client nicht mehr vorhanden ist, wird der Fehler 499 protokolliert. |
| 502 Ungültiges Gateway | Dieser Fehler tritt auf, wenn Sie für eine Verbindung HTTP anstelle von HTTPS eingeben. |
| 503 Dienst nicht verfügbar | Dieser Fehler bedeutet, dass die Auslastung des Systems sehr hoch ist und Ihre Anforderungen aktuell nicht verarbeitet werden können. Wichtig: In diesem Fall wird dringend empfohlen, den Clientcode zurückzuschalten und zu warten, bevor es erneut versucht wird. Dadurch hat das System ausreichend Zeit für eine Wiederherstellung, und die Wahrscheinlichkeit, dass spätere Anforderungen gelingen, steigt. Wenn Sie Ihre Anforderungen schnell wiederholen, dauert das Problem nur an. Weitere Informationen zur Drosselung und zum Verhindern dieser Bedingung finden Sie unter Analysieren der Leistung . |
| 504: Gatewaytimeout | Azure KI Search lauscht auf HTTPS-Port 443. Wenn Ihre Suchdienst-URL HTTP anstelle von HTTPS enthält, wird ein 504-status-Code zurückgegeben. |