API-versioner i Azure AI-sökning

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

Azure AI-sökning distribuerar funktionsuppdateringar regelbundet. Ibland, men inte alltid, kräver dessa uppdateringar en ny version av API:et för att bevara bakåtkompatibilitet. Genom att publicera en ny version kan du styra när och hur du integrerar uppdateringar av söktjänsten i koden.

I regel är REST-API:er och Azure SDKs klientbibliotek endast versionshanterade när det behövs, eftersom det kan innebära en viss ansträngning att uppgradera koden för att använda en ny API-version. En ny version behövs bara om någon aspekt av API:et har ändrats på ett sätt som bryter bakåtkompatibiliteten. Sådana ändringar kan inträffa på grund av korrigeringar av befintliga funktioner eller på grund av nya funktioner som ändrar befintlig API-yta.

Mer information om utfasningsprocessen finns i Azure SDKs livscykel och supportpolicy.

Inaktuella versioner

2023-07-01-preview blev inaktuell den 8 april 2024 och stöds inte längre från och med den 8 juli 2024. Den här versionen var det första REST-API:et som erbjöd stöd för vektorsökning. Nyare API-versioner har en annan vektorkonfiguration. Migrera till en nyare API-version eller till en nyare SDK-version så snart som möjligt.

Utgångna versioner

Från och med den 15 oktober 2020 upphör följande API-versioner och dokumenteras eller stöds inte längre:

• 2015-02-28
• 2015-02-28-Preview
• 2014-07-31-Preview
• Förhandsversion 2014-10-20

Alla SDK:er baseras på REST API-versioner. Om en REST API-version upphör upphör även SDK-paketen baserat på den. Alla Azure AI-sökning .NET SDK:er som är äldre än 3.0.0-rc är nu föråldrade.

Om du har kod som använder en utgången version migrerar du till en nyare API-version eller till en nyare SDK-version.

REST API:er

REST-API	Länk
Söktjänst (dataplanet)	Se API-versioner i REST API-referensen.
Sökhantering (kontrollplan)	Se API-versioner i REST API-referensen.

Azure SDKs för .NET

SDK-version	Status	Ändringslogg	beskrivning
Azure. Search.Documents 12	Aktiv	Ändringsloggen	API:er för dataplansåtgärder i en tjänst, till exempel läs- och skrivåtgärder för innehåll och objekt.
Azure. ResourceManager.Search	Aktiv	Ändringsloggen	API:er för kontrolloperationsåtgärder i söktjänsten.

Azure SDKs för Java

SDK-version	Status	Ändringslogg	beskrivning
azure-search-documents 12	Aktiv	Ändringsloggen	Använd azure-search-documents klientbiblioteket för att utföra åtgärder i dataplanet.
azure-resourcemanager-search 2	Aktiv	Ändringsloggen	Använd azure-resourcemanager-search klientbiblioteket för kontrollplansåtgärder.

Azure SDKs för JavaScript

SDK-version	Status	Ändringslogg	beskrivning
@azure/sökdokument 13	Aktiv	Ändringsloggen	Använd @azure/search-documents klientbiblioteket för att utföra åtgärder i dataplanet.
@azure/arm-search 4	Aktiv	Ändringsloggen	Använd paketet @azure/arm-search för kontrollplansåtgärder.

Azure SDKs för Python

SDK-version	Status	Ändringslogg	beskrivning
azure-search-documents 12	Aktiv	Ändringsloggen	Använd azure-search-documents klientbiblioteket för att utföra åtgärder i dataplanet.
azure-mgmt-search 9	Aktiv	Ändringsloggen	Använd azure-mgmt-search klientbiblioteket för kontrollplansåtgärder.

Alla Azure-SDK:er

Om du letar efter betaklientbibliotek och dokumentation innehåller den här sidan länkar till alla Azure SDKs bibliotekspaket, kod och dokument.