HTTP-Statuscodes (Azure Cognitive Search)

Diese Seite beschreibt die HTTP-Statuscodes, die häufig zurückgegeben werden, wenn die Azure Cognitive Search-API verwendet wird.

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 nach Abschluss des Indizierungsvorgangs ein paar Sekunden abfragbar und durchsuchbar.
201 – Erstellt Erfolgreiche Ausführung von PUT oder POST. Objekt wurde erstellt oder erfolgreich 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 Dieser Code wird zurückgegeben, wenn im Anforderungs-URI, Header oder Textteil ein Fehler aufgetreten ist. Der Antworttext enthält eine Fehlermeldung, die das jeweilige Problem erläutert.
403 Verboten Dieser Code wird zurückgegeben, wenn Sie einen ungültigen API-Schlüssel übergeben.
404 – Nicht gefunden Dieser Code 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 stellen Sie sicher, dass der Indexname ordnungsgemäß angegeben ist.
409 – Konflikt Beim Konflikt mit Schreibvorgängen zurückgegeben. Dieser Fehler wird für Ressourcenupdates oder während der Indizierung zurückgegeben, wenn zwei Prozesse versuchen, dasselbe Dokument gleichzeitig zu aktualisieren. Azure Cognitive Search stellt die Parallelitätsverwaltung für Ressourcenupdates bereit. Weitere Informationen finden Sie unter "Verwalten der Parallelität in Azure Cognitive Search".
412 Precondition Failed Wird zurückgegeben, wenn die Bedingung eines If-Match- oder If-None-Match-Headers auf "false" ausgewertet wird. Verknüpft mit der Verwendung optimistischer Parallelitätssteuerung beim Senden von HTTP-Anforderungen für Indexdefinitionen, Indexer oder Datenquellen.
429 – Zu viele Anforderungen Wenn dieser Fehler bei der Indexerstellung auftritt, bedeutet dies, dass Sie bereits über die maximale Anzahl von Indizes verfügen, die für Ihre Preisstufe zugelassen sind. Eine Anzahl der in Azure Cognitive Search gespeicherten Indizes ist im Suchdienstdashboard im Azure-Portal sichtbar. Um die Indizes nach Namen anzuzeigen, klicken Sie auf die Kachel Index. Alternativ können Sie auch eine Liste der Indizes mithilfe des Vorgangs "Listenindizes " abrufen. Details finden Sie unter Indizes auflisten .

Wenn dieser Fehler beim Hochladen von Dokumenten auftritt, haben Sie Ihr Kontingent für die Anzahl der Dokumente pro Index überschritten. Erstellen Sie in diesem Fall entweder einen neuen Index oder aktualisieren Sie auf höhere Kapazitätsgrenzen.
499 Client-Geschlossene Anforderung Dieser Fehler wird niemals in einer Antwort zurückgegeben, sie wird jedoch möglicherweise in Protokolleinträgen angezeigt, die von Suchdatenverkehranalyse und Azure Monitor aufgezeichnet werden. Es gibt an, dass ein Client die Verbindung geschlossen hat, bevor eine Antwort vom Dienst zurückgegeben wurde. Wenn Azure Cognitive Search einen Abbruch erkennt, der nicht vom dienstseitigen Code angefordert wurde oder dass der Client nicht mehr vorhanden ist, wird ein 499-Fehler 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, dass Der Clientcode wieder deaktiviert ist, und warten Sie, bevor Sie erneut versuchen. 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.
504: Gatewaytimeout Die kognitive Azure-Suche lauscht an HTTPS-Port 443. Wenn Ihre Suchdienst-URL HTTP anstelle von HTTPS enthält, wird ein 504-Statuscode zurückgegeben.

Weitere Informationen