HTTP-statuscodes (Azure AI Search)
Op deze pagina worden de HTTP-statuscodes beschreven die vaak worden geretourneerd bij het gebruik van de Azure AI Search-API.
Algemene HTTP-statuscodes
| Code | Description |
|---|---|
| 200 OK | Succes op GET, PUT of POST. Geretourneerd voor een geslaagd antwoord. Tijdens het indexeren geeft deze code aan dat alle items duurzaam zijn opgeslagen en worden geïndexeerd. Indexering wordt op de achtergrond uitgevoerd en maakt nieuwe documenten doorzoekbaar en doorzoekbaar enkele seconden nadat de indexeringsbewerking is voltooid. |
| 201 Gemaakt | Succes op PUT of POST. Het object is gemaakt of bijgewerkt. |
| 204 Geaccepteerd | Succes op PUT of POST. De index of documenten zijn geüpload. |
| 207 Multi-Status | Gedeeltelijk geslaagd voor PUT of POST. Sommige documenten zijn geslaagd, maar ten minste één is mislukt. |
| 400 Ongeldige aanvraag | Wordt geretourneerd wanneer er een fout optreedt in de aanvraag-URI, headers of hoofdtekst. De hoofdtekst van het antwoord bevat een foutbericht waarin wordt uitgelegd wat het specifieke probleem is. |
| 403 Verboden | Wordt geretourneerd wanneer u een ongeldige API-sleutel doorgeeft. |
| 404 Niet gevonden | Wordt geretourneerd wanneer er geen resource op de server bestaat. Als u een index beheert of er query's op uitvoert, controleert u de syntaxis en controleert u of de indexnaam juist is opgegeven. |
| Methode 405 wordt niet ondersteund | Wordt geretourneerd wanneer de aanvraag een methode opgeeft die wordt herkend, maar niet wordt ondersteund. Als u een query uitvoert op een index, bevat de formulering van die aanvraag het eindpunt, de indexenverzameling en -index, en de docs-verzameling en de zoekmethode (bijvoorbeeld https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 Conflict | Wordt geretourneerd wanneer schrijfbewerkingen conflicteert. Deze fout wordt geretourneerd voor resource-updates of tijdens het indexeren wanneer twee processen hetzelfde document tegelijk proberen bij te werken. Azure AI Search biedt gelijktijdigheidsbeheer voor resource-updates. Zie Gelijktijdigheid beheren in Azure AI Search voor meer informatie. |
| 412 Voorwaarde is mislukt | Wordt geretourneerd wanneer de voorwaarde van een If-Match- of If-None-Match-header resulteert in false. Gekoppeld aan het gebruik van optimistisch gelijktijdigheidsbeheer bij het verzenden van HTTP-aanvragen voor indexdefinities, indexeerfuncties of gegevensbronnen. |
| 429 Te veel aanvragen | Als deze fout optreedt terwijl u een index probeert te maken, betekent dit dat u al het maximum aantal indexen hebt dat is toegestaan voor uw prijscategorie. Een telling van de indexen die zijn opgeslagen in Azure AI Search is zichtbaar in het zoekservicedashboard op de Azure Portal. Als u de indexen op naam wilt weergeven, selecteert u de tegel Index . U kunt ook een lijst met indexen op naam ophalen met behulp van de bewerking Indexen weergeven . Zie Indexen weergeven voor meer informatie. Als deze fout optreedt tijdens het uploaden van documenten, geeft dit aan dat u uw quotum voor het aantal documenten per index hebt overschreden. U moet een nieuwe index maken of upgraden voor hogere capaciteitslimieten. |
| 499 Gesloten clientaanvraag | Deze fout wordt nooit geretourneerd in een antwoord, maar u ziet deze mogelijk in logboekvermeldingen die zijn vastgelegd door search traffic analytics en Azure Monitor. Het geeft aan dat een client de verbinding heeft gesloten voordat een antwoord door de service is geretourneerd. Wanneer Azure AI Search een annulering detecteert die niet is aangevraagd door code aan de servicezijde, of wanneer de client niet meer bestaat, wordt een 499-fout geregistreerd. |
| 502 Ongeldige gateway | Deze fout treedt op wanneer u HTTP invoert in plaats van HTTPS in de verbinding. |
| 503 Service niet beschikbaar | Deze fout betekent dat het systeem zwaar belast wordt en uw aanvraag op dit moment niet kan worden verwerkt. Belangrijk: In dit geval raden we u ten zeerste aan om uw clientcode uit te schakelen en te wachten voordat u het opnieuw probeert. Hierdoor krijgt het systeem de tijd om te herstellen, waardoor toekomstige aanvragen waarschijnlijk wel mogelijk zijn. Als u uw aanvraag snel opnieuw probeert te doen, wordt de situatie alleen maar verlengd. Zie Prestaties analyseren voor meer informatie over beperking en hoe u deze voorwaarde kunt voorkomen. |
| 504: Time-out van gateway | Azure AI Search luistert op HTTPS-poort 443. Als de URL van uw zoekservice HTTP bevat in plaats van HTTPS, wordt een 504-statuscode geretourneerd. |