Läs på engelska

Dela via


API-versioner i Azure AI Search

Azure AI Search 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 bibliotek 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 utfasningssökvägen finns i Livscykel och supportprincip för Azure SDK.

Inaktuella versioner

2023-07-01-preview blev inaktuell den 8 april 2024 och kommer inte att stödjas efter den 8 juli 2024.

Det här var det första REST-API:et som erbjöd stöd för vektorsökning. Nyare API-versioner har en annan vektorkonfiguration. Du bör migrera till en nyare version så snart som möjligt.

Utgångna versioner

Vissa API-versioner upphör och avvisas av en söktjänst:

  • 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-version upphör upphör även SDK-paket baserade på den versionen. Alla Azure AI Search .NET SDK:er som är äldre än 3.0.0-rc är nu föråldrade.

Stödet för ovanstående versioner upphörde den 15 oktober 2020. Om du har kod som använder en utgående version kan du migrera befintlig kod till en nyare REST API-version eller till en nyare Azure SDK.

REST API:er

REST-API Länk
Söktjänst (dataplan) Se API-versioner i REST API-referens
Hantering (kontrollplan) Se API-versioner i REST API-referens

Azure SDK för .NET

Följande tabell innehåller länkar till nyare SDK-versioner.

SDK-version Status beskrivning
Azure.Search.Documents 11 Aktiv Nytt klientbibliotek från Azure .NET SDK-teamet, som ursprungligen släpptes juli 2020. Mer information om mindre versioner finns i ändringsloggen.
Microsoft.Azure.Search 10 Kasserad Släpptes maj 2019. Det här är den sista versionen av Microsoft.Azure.Search-paketet och det är nu inaktuellt. Den har slutförts av Azure.Search.Documents.
Microsoft.Azure.Management.Search 4.0.0 Aktiv Mål för REST-api-version för hantering=2020-08-01.
Microsoft.Azure.Management.Search 3.0.0 Kasserad Riktar sig till Hanterings-REST api-version=2015-08-19.

Azure SDK för Java

SDK-version Status beskrivning
Java azure-search-documents 11 Aktiv azure-search-documents Använd klientbiblioteket för dataplansåtgärder.
Java Management Client 1.35.0 Aktiv azure-mgmt-search Använd klientbiblioteket för kontrollplansåtgärder.

Azure SDK för Java Script

SDK-version Status beskrivning
JavaScript @azure/search-documents 11.0 Aktiva @azure/search-documents Använd klientbiblioteket för dataplansåtgärder.
JavaScript @azure/arm-search Aktiv @azure/arm-search Använd klientbiblioteket för kontrollplansåtgärder.

Azure SDK för Python

SDK-version Status beskrivning
Python azure-search-documents 11.0 Aktiv azure-search-documents Använd klientbiblioteket för dataplansåtgärder.
Python azure-mgmt-search 8.0 Aktiv azure-mgmt-search Använd 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 SDK-bibliotekspaket, kod och dokument.