HTTP-statuskoder (Azure AI Search)

På den här sidan beskrivs de HTTP-statuskoder som ofta returneras när du använder REST-API:er för Azure AI Search.

Vanliga HTTP-statuskoder

Kod	Beskrivning
200 Okej	Lyckades med GET, PUT eller POST. Returnerades för ett lyckat svar.
201 Skapad	Lyckades med PUT eller POST. Objektet har skapats.
202 Accepterad	Lyckades med PUT eller POST. Den här statuskoden returneras för körningsindexeringsbegäranden.
204 inget innehåll	Lyckades med PUT eller POST. En uppdatering lyckades men det finns ingen information att returnera i svaret.
206 Delvis innehåll	Delvis lyckad GET eller POST för hämtning av kunskapsbas i arbetsflöden för agenthämtning. Returneras när begäran lyckades men vissa icke-kritiska komponenter i hämtnings- eller rangordningsprocessen misslyckades, vilket ledde till ofullständiga resultat eller rangordningar som kanske inte återspeglar den fullständiga relevansbedömningen.
207 Flera Status	Delvis lyckad på PUT eller POST. Vissa dokument lyckades, men minst ett misslyckades.
400 Felaktig begäran	Returneras när det finns ett fel i begärande-URI:n, rubrikerna eller brödtexten. Svarstexten innehåller ett felmeddelande som förklarar vad det specifika problemet är.
401 Inte auktoriserad	Returneras när autentiseringsuppgifter saknas. Om du använder rollbaserad åtkomstkontroll saknar du eller söktjänsten en rolltilldelning. Problem med att komma åt Azure AI Search finns i Ansluta till Azure AI Search med hjälp av roller. Mer information om sökanslutningar till andra resurser finns i Konfigurera en söktjänst för att ansluta med hjälp av en hanterad identitet.
402 Betalning krävs	Returneras när den månatliga tilldelningen av kostnadsfria semantiska rankningsbegäranden är uttömd. Du kan också se det här felet: "Den kostnadsfria semantiska användningen av frågor har överskridits för månaden. Aktivera semantisk fakturering för att fortsätta använda semantisk sökning https://aka.ms/SemanticPriceDocPage". För att lösa felet, byt från den kostnadsfria planen till standardfakturering.
403 – Förbjuden	Returneras när auktoriseringen misslyckas.
404 – Hittades inte	Returneras när en resurs inte finns på servern.
405-metoden stöds inte	Returneras när tjänsten identifierar en metod som inte stöds. Om du kör frågor mot ett index innehåller formuleringen av den begäran slutpunkten, indexsamlingen och indexet samt dokumentsamlingen och sökmetoden (till exempel https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 – Konflikt	Returneras när skrivåtgärderna är i konflikt. Den här statuskoden returneras för resursuppdateringar eller under indexering när två processer försöker uppdatera samma dokument samtidigt. Azure AI Search tillhandahåller samtidighetshantering för resursuppdateringar. Mer information finns i Hantera samtidighet i Azure AI Search.
412 Förhandsvillkoret misslyckades	Returneras när ett If-Match eller If-None-Match-huvudets villkor utvärderas till false. Associerad med att använda optimistisk samtidighetskontroll när http-begäranden skickas för indexdefinitioner, indexerare, kompetensuppsättningar eller datakällor.
415 Medietyp som inte stöds	Detta fel kan uppstå om du använder CURL eller kommandoradsåtgärder för att skicka JSON i en objektdefinition eller förfrågan, och begäransökan-headern specificerar inte någon innehållstyp av applikation/json. För CURL, om du använder flaggan -d (som som standard är x-www-form-urlencoded), kan du ersätta den flaggan med flaggan --json (som som standard är application/json), eller lägga till -H "Content-Type: application/json".
429 För många förfrågningar	Om du får den här statuskoden när objektet skapas innebär det att du har det maximala antalet objekt som tillåts för tjänstnivån. Om du får den här felkoden för ett aktivt index innebär det vanligtvis att du har ont om lagringsutrymme. När du närmar dig lagringsgränser kan tjänsten ange ett tillstånd där du inte kan lägga till eller uppdatera förrän du tar bort vissa dokument. Mer information finns i Planera och hantera kapacitet om du vill ha mer lagringsutrymme eller Uppdatera innehåll om du vill frigöra utrymme genom att ta bort dokument.
499 Klient stängd begäran	Den här statuskoden returneras aldrig i ett svar, men du kan se den i loggposter som registrerats av söktrafikanalys och Azure Monitor. Det anger att en klient stängde anslutningen innan ett svar returnerades av tjänsten. När Azure AI Search identifierar en annullering som inte begärdes av kod på tjänstsidan, eller om klienten inte längre finns, loggas en 499.
502 Felaktig gateway	Den här statuskoden inträffar när du anger HTTP i stället för HTTPS i anslutningen.
503 Tjänsten är inte tillgänglig	Den här statuskoden innebär att systemet är hårt belastat och att din begäran inte kan bearbetas. Du kan till exempel lägga till väntetider i eventuell logik för återförsök eller öka kapaciteten. Nyare tjänster levereras med mer lagrings- och databehandlingskraft automatiskt. Mer information om prestandajustering finns i Analysera prestanda i Azure AI Search.
504: Tidsgräns för gateway	Azure AI Search lyssnar på HTTPS-port 443. Om söktjänstens URL innehåller HTTP i stället för HTTPS returneras en 504-statuskod.

Se även

• REST-API:er för Azure AI Search