Delen via

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 Beschrijving
200 OK Succes bij GET, PUT of POST. Geretourneerd voor een geslaagd antwoord.
201 Aangemaakt Succes op PUT of POST. Het object is gemaakt.
202 Geaccepteerd Succes op PUT of POST. Deze statuscode wordt geretourneerd voor het uitvoeren van indexeeraanvragen.
204 Geen inhoud Succes op PUT of POST. Er is een update voltooid, maar er is geen informatie om terug te keren in het antwoord.
207 Multi-Status Gedeeltelijk succes voor PUT of POST. Sommige documenten zijn geslaagd, maar ten minste één is mislukt.
400 Foute Verzoek 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.
401 Niet geautoriseerd Geretourneerd wanneer referenties ontbreken. Als u op rollen gebaseerd toegangsbeheer gebruikt, ontbreken er een roltoewijzing door u of de zoekservice. Zie Verbinding maken met Azure AI Search met behulp van rollen voor problemen met toegang tot Azure AI Search. Zie Een zoekservice configureren om verbinding te maken met een beheerde identiteit voor meer informatie over zoekverbindingen met andere resources.
403 Verboden Geretourneerd wanneer autorisatie mislukt.
404 Niet gevonden Wordt geretourneerd wanneer er geen resource op de server bestaat.
Methode 405 wordt niet ondersteund Geretourneerd wanneer de service een niet-ondersteunde methode herkent. Als u een query uitvoert op een index, bevat de formulering van die aanvraag het eindpunt, de verzameling indexen en de verzameling documenten en de zoekmethode (bijvoorbeeld https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 Conflict Geretourneerd wanneer schrijfbewerkingen conflicteren. Deze statuscode wordt geretourneerd voor resource-updates of tijdens het indexeren wanneer twee processen hetzelfde document tegelijkertijd proberen bij te werken. Azure AI Search biedt gelijktijdigheidsbeheer voor resource-updates. Zie Gelijktijdigheid beheren in Azure AI Search voor meer informatie.
412 Voorwaarde mislukt Geretourneerd wanneer de voorwaarde van een If-Match of If-None-Match header onwaar is. Gekoppeld aan het gebruik van optimistisch gelijktijdigheidsbeheer bij het verzenden van HTTP-aanvragen voor indexdefinities, indexeerfuncties, vaardighedensets of gegevensbronnen.
429 Te veel aanvragen Als u deze statuscode krijgt tijdens het maken van objecten, betekent dit dat u het maximum aantal objecten hebt dat is toegestaan voor uw servicelaag. Als u deze foutcode voor een actieve index krijgt, betekent dit meestal dat u weinig opslagruimte hebt. Wanneer u de opslaglimieten bijna hebt bereikt, kan de service een status invoeren waarin u niet kunt toevoegen of bijwerken totdat u bepaalde documenten verwijdert. Zie Capaciteit plannen en beheren als u meer opslagruimte wilt of Inhoud bijwerken als u ruimte wilt vrijmaken door documenten te verwijderen voor meer informatie.
499 Gesloten aanvraag van client Deze statuscode wordt nooit geretourneerd in een antwoord, maar u ziet deze mogelijk in logboekvermeldingen die zijn vastgelegd door traffic analytics en Azure Monitor. Er wordt aangegeven dat een client de verbinding heeft gesloten voordat een antwoord door de service werd geretourneerd. Wanneer Azure AI Search een annulering detecteert die niet is aangevraagd door code aan de servicezijde of dat de client niet meer bestaat, wordt een 499 geregistreerd.
502 Ongeldige gateway Deze statuscode vindt plaats wanneer u HTTP invoert in plaats van HTTPS in de verbinding.
503-service niet beschikbaar Deze statuscode betekent dat het systeem zwaar wordt belast en uw aanvraag niet kan worden verwerkt. Oplossingen zijn het toevoegen van wachttijden aan elke logica voor opnieuw proberen of het verhogen van de capaciteit. Nieuwere services worden automatisch geleverd met meer opslag- en rekenkracht. Zie Prestaties analyseren in Azure AI Search voor meer informatie over het afstemmen van prestaties.
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 er een 504-statuscode geretourneerd.

Zie ook