Freigeben über

HTTP-Statuscodes (Azure AI Search)

Auf dieser Seite werden die HTTP-Statuscodes beschrieben, die bei Verwendung der Azure AI Search-API häufig zurückgegeben werden.

Allgemeine HTTP-Statuscodes

Code BESCHREIBUNG
200 OK Erfolg bei GET, PUT oder POST. Wird für eine erfolgreiche Antwort zurückgegeben.
201 (Erstellt) Erfolg bei PUT oder POST. Das Objekt wurde erfolgreich erstellt.
202 Akzeptiert Erfolg bei PUT oder POST. Dieser Statuscode wird für Ausführungsindexanforderungen zurückgegeben.
204 Kein Inhalt Erfolg bei PUT oder POST. Ein Update war erfolgreich, aber es gibt keine Informationen, die in der Antwort zurückgegeben werden sollen.
207 Multi-Status Teilweiser Erfolg für PUT oder POST. Einige Dokumente konnten erfolgreich ausgeführt werden, aber mindestens ein Fehler.
400 Fehlerhafte Anfrage Wird zurückgegeben, wenn ein Fehler im Anforderungs-URI, Header oder Textkörper vorliegt. Der Antworttext enthält eine Fehlermeldung, in der erläutert wird, was das spezifische Problem ist.
401 Nicht autorisiert Wird zurückgegeben, wenn Anmeldeinformationen fehlen. Wenn Sie die rollenbasierte Zugriffssteuerung verwenden, fehlen Ihnen oder dem Suchdienst eine Rollenzuweisung. Probleme beim Zugriff auf Azure AI Search finden Sie unter Herstellen einer Verbindung mit Azure AI Search mithilfe von Rollen. Weitere Informationen zu Suchverbindungen mit anderen Ressourcen finden Sie unter Konfigurieren eines Suchdiensts für die Verbindung mit einer verwalteten Identität.
403 Verboten Wird zurückgegeben, wenn die Autorisierung fehlschlägt.
404 nicht gefunden Wird zurückgegeben, wenn eine Ressource nicht auf dem Server vorhanden ist.
405-Methode nicht unterstützt Wird zurückgegeben, wenn der Dienst eine nicht unterstützte Methode erkennt. Wenn Sie einen Index abfragen, enthält die Formulierung dieser Anforderung den Endpunkt, die Sammlung und den Index sowie die Docs-Auflistung und die Suchmethode (z. B https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01. ).
Konflikt 409 Wird zurückgegeben, wenn Schreibvorgänge in Konflikt geraten. Dieser Statuscode wird für Ressourcenaktualisierungen oder während der Indizierung zurückgegeben, wenn zwei Prozesse versuchen, dasselbe Dokument gleichzeitig zu aktualisieren. Azure AI Search bietet Parallelitätsverwaltung für Ressourcenupdates. Weitere Informationen finden Sie unter Verwalten der Parallelität in Azure AI Search.
412 Fehler bei Vorbedingung Wird zurückgegeben, wenn die Bedingung eines If-Match- oder If-None-Match Headers als "false" ausgewertet wird. Verknüpft mit der Verwendung optimistischer Parallelitätssteuerung beim Senden von HTTP-Anforderungen für Indexdefinitionen, Indexer, Skillsets oder Datenquellen.
429 – Zu viele Anforderungen Wenn Sie diesen Statuscode während der Objekterstellung erhalten, bedeutet dies, dass Sie die maximale Anzahl von Objekten haben, die für Die Dienstebene zulässig sind. Wenn Sie diesen Fehlercode für einen aktiven Index erhalten, bedeutet dies in der Regel, dass Sie wenig Speicher haben. Während Sie speichergrenzbar sind, kann der Dienst einen Zustand eingeben, in dem Sie einige Dokumente erst hinzufügen oder aktualisieren können, wenn Sie einige Dokumente löschen. Weitere Informationen finden Sie unter "Planen und Verwalten von Kapazität ", wenn Sie mehr Speicher benötigen oder Inhalte aktualisieren möchten, wenn Sie Speicherplatz freigeben möchten, indem Sie Dokumente löschen.
499 Client geschlossene Anforderung Dieser Statuscode wird niemals in einer Antwort zurückgegeben, sie wird jedoch möglicherweise in Protokolleinträgen angezeigt, die von suchdatenverkehranalyse und Azure Monitor aufgezeichnet wurden. Es gibt an, dass ein Client die Verbindung geschlossen hat, bevor eine Antwort vom Dienst zurückgegeben wurde. Wenn Azure AI Search einen Abbruch erkennt, der nicht vom dienstseitigen Code angefordert wurde oder der Client nicht mehr vorhanden ist, wird ein 499 protokolliert.
502 Ungültiges Gateway Dieser Statuscode tritt auf, wenn Sie HTTP anstelle von HTTPS in die Verbindung eingeben.
503 Dienst nicht verfügbar Dieser Statuscode bedeutet, dass das System stark geladen ist und Ihre Anforderung nicht verarbeitet werden kann. Zu den Entschärfungen gehören das Hinzufügen von Wartezeiten zu jeder Wiederholungslogik oder zur Erhöhung der Kapazität. Neuere Dienste verfügen über mehr Speicher- und Computerleistung automatisch. Weitere Informationen zur Leistungsoptimierung finden Sie unter Analysieren der Leistung in Azure AI Search.
504: Gatewaytimeout Azure AI Search lauscht auf HTTPS-Port 443. Wenn Ihre Suchdienst-URL HTTP anstelle von HTTPS enthält, wird ein 504-Statuscode zurückgegeben.

Siehe auch