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.
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.
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 | Länk |
---|---|
Söktjänst (dataplan) | Se API-versioner i REST API-referens |
Hantering (kontrollplan) | Se API-versioner i REST API-referens |
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. |
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. |
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. |
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. |
Om du letar efter betaklientbibliotek och dokumentation innehåller den här sidan länkar till alla Azure SDK-bibliotekspaket, kod och dokument.