Delen via


API-versies in Azure AI Search

Azure AI Search implementeert regelmatig functie-updates. Soms, maar niet altijd, vereisen deze updates een nieuwe versie van de API om compatibiliteit met eerdere versies te behouden. Door een nieuwe versie te publiceren, kunt u bepalen wanneer en hoe u zoekservice-updates in uw code integreert.

In de regel worden de REST API's en bibliotheken alleen geversied wanneer dat nodig is, omdat het enige inspanning kan vergen om uw code te upgraden om een nieuwe API-versie te gebruiken. Er is alleen een nieuwe versie nodig als een bepaald aspect van de API is gewijzigd op een manier die compatibiliteit met eerdere versies onderbreekt. Dergelijke wijzigingen kunnen optreden vanwege oplossingen voor bestaande functies of vanwege nieuwe functies die bestaande API-oppervlakte wijzigen.

Zie de levenscyclus en het ondersteuningsbeleid voor Azure SDK voor meer informatie over het afschaffingspad.

Afgeschafte versies

2023-07-01-preview is afgeschaft op 8 april 2024 en wordt niet ondersteund na 8 juli 2024.

Dit was de eerste REST API die ondersteuning voor vectorzoekopdrachten bood. Nieuwere API-versies hebben een andere vectorconfiguratie. U moet zo snel mogelijk migreren naar een nieuwere versie .

Stopgezette versies

Sommige API-versies worden stopgezet en worden niet meer gedocumenteerd of ondersteund:

  • 2015-02-28
  • 2015-02-28-Preview
  • 2014-07-31-Preview
  • 2014-10-20-Preview

Alle SDK's zijn gebaseerd op REST API-versies. Als een REST-versie wordt stopgezet, worden SDK-pakketten op basis van die versie ook stopgezet. Alle Azure AI Search .NET SDK's ouder dan 3.0.0-rc zijn nu verouderd.

Ondersteuning voor de bovenstaande versies is beëindigd op 15 oktober 2020. Als u code hebt die gebruikmaakt van een stopgezette versie, kunt u bestaande code migreren naar een nieuwere REST API-versie of naar een nieuwere Azure SDK.

REST-API's

REST-API Koppeling
Zoekservice (gegevensvlak) Zie API-versies in de REST API-verwijzing.
Zoekbeheer (besturingsvlak) Zie API-versies in de REST API-verwijzing.

Azure-SDK voor .NET

De volgende tabel bevat koppelingen naar recentere SDK-versies.

SDK-versie Status Wijzigingenlogboek Beschrijving
Azure.Search.Documents 11 Actief Wijzigingenlogboek API's voor bewerkingen in een gegevensvlak in een service, zoals lees-schrijfbewerkingen voor inhoud en objecten.
Azure.ResourceManager.Search Actief Wijzigingenlogboek API's voor besturingsvlakbewerkingen in de zoekservice.

Azure SDK voor Java

SDK-versie Status Wijzigingenlogboek Beschrijving
azure-search-documents 11 Actief Wijzig logboekgebruik de azure-search-documents clientbibliotheek voor bewerkingen in het gegevensvlak.
azure-resourcemanager-search 2 Actief Wijzigingenlogboek Gebruik de azure-resourcemanager-search clientbibliotheek voor besturingsvlakbewerkingen.

Azure-SDK voor JavaScript

SDK-versie Status Wijzigingenlogboek Beschrijving
@azure/search-documents 12 Actief Wijzigingenlogboek Gebruik de clientbibliotheek voor bewerkingen in het @azure/search-documents gegevensvlak.
@azure/arm-search 4 Actief Wijzigingenlogboek Gebruik het @azure/arm-search pakket voor besturingsvlakbewerkingen.

Azure-SDK voor Python

SDK-versie Status Wijzigingenlogboek Beschrijving
azure-search-documents 11 Actief Wijzigingenlogboek Gebruik de clientbibliotheek voor bewerkingen in het azure-search-documents gegevensvlak.
azure-mgmt-search 9 Actief Wijzigingenlogboek Gebruik de azure-mgmt-search clientbibliotheek voor besturingsvlakbewerkingen.

Alle Azure-SDK's

Als u op zoek bent naar bètaclientbibliotheken en documentatie, bevat deze pagina koppelingen naar alle Azure SDK-bibliotheekpakketten, code en documenten.