API-Versionen in Azure KI Search

Für Azure KI Search sind regelmäßig Featureupdates verfügbar. Manchmal, aber nicht immer, erfordern diese Updates eine neue Version der API, um die Abwärtskompatibilität zu gewährleisten. Die Veröffentlichung einer neuen Version ermöglicht Ihnen, zu steuern, wann und wie Sie Suchdienstupdates in Ihren Code integrieren.

In der Regel erfolgt für REST-APIs und Bibliotheken eine Versionsangabe nur im Bedarfsfall, da es einen gewissen Aufwand erfordern kann, wenn Sie Ihren Code aktualisieren, um eine neue API-Version zu verwenden. Eine neue Version ist nur dann erforderlich, wenn sich ein Aspekt der API in einer Weise geändert hat, die die Abwärtskompatibilität beeinträchtigt. Ursache für solche Änderungen können Fehlerbehebungen bei vorhandenen Funktionen sein oder neue Funktionen, die vorhandene API-Oberflächenbereiche ändern.

Weitere Informationen zur Einstellung finden Sie unter Lebenszyklus und Supportrichtlinie des Azure SDK.

Nicht unterstützte Versionen

Einige API-Versionen werden nicht mehr unterstützt und von einem Suchdienst abgelehnt:

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

Alle SDKs basieren auf REST-API-Versionen. Wenn eine REST-Version nicht mehr vorhanden ist, werden sdk-Pakete, die auf dieser Version basieren, ebenfalls nicht mehr unterstützt. Alle Azure AI Search .NET SDKs, die älter als 3.0.0-rc sind, sind jetzt veraltet.

Der Support für die oben aufgeführten Versionen endete am 15. Oktober 2020. Wenn Sie über Code verfügen, der eine Version verwendet, deren Unterstützung eingestellt wurde, können Sie vorhandenen Code zu einer neueren REST-API-Version oder einem neueren Azure-SDK migrieren.

REST-APIs

REST-API Link
Suchdienst (Datenebene) Weitere Informationen finden Sie unter API-Versionen in der REST-API-Referenz.
Verwaltung (Steuerungsebene) Weitere Informationen finden Sie unter API-Versionen in der REST-API-Referenz.

Azure SDK für .NET

In der folgenden Tabelle finden Sie Links zu neueren SDK-Versionen:

SDK-Version Status Beschreibung
Azure.Search.Documents 11 Aktiv Neue Clientbibliothek vom Azure .NET SDK-Team, erstmalig veröffentlicht im Juli 2020. Informationen zu Nebenversionen finden Sie im Änderungsprotokoll.
Microsoft.Azure.Search 10 Zurückgezogen Veröffentlichung: Mai 2019 Dies ist die letzte Version des Microsoft.Azure.Search-Pakets. Sie ist jetzt veraltet. Sie wird von Azure.Search.Documents abgelöst.
Microsoft.Azure.Management.Search 4.0.0 Aktiv Gilt für die Verwaltungs-REST-API-Version 2020-08-01.
Microsoft.Azure.Management.Search 3.0.0 Zurückgezogen Gilt für die Management REST-API, api-version=2015-08-19.

Azure SDK für Java

SDK-Version Status Beschreibung
Java azure-search-documents 11 Aktiv Verwenden Sie die azure-search-documents Clientbibliothek für Datenebenenvorgänge.
Java Management Client 1.35.0 Aktiv Verwenden Sie die azure-mgmt-search Clientbibliothek für Steuerungsebenenvorgänge.

Azure SDK für JavaScript

SDK-Version Status BESCHREIBUNG
JavaScript @azure/search-documents 11.0 Aktiv Verwenden Sie die @azure/search-documents Clientbibliothek für Datenebenenvorgänge.
JavaScript @azure/arm-search Aktiv Verwenden Sie die @azure/arm-search Clientbibliothek für Steuerungsebenenvorgänge.

Azure SDK für Python

SDK-Version Status Beschreibung
Python azure-search-documents 11.0 Aktiv Verwenden Sie die azure-search-documents Clientbibliothek für Datenebenenvorgänge.
Python azure-mgmt-search 8.0 Aktiv Verwenden Sie die azure-mgmt-search Clientbibliothek für Steuerungsebenenvorgänge.

Alle Azure SDKs

Wenn Sie nach Beta-Clientbibliotheken und -Dokumentation suchen, enthält diese Seite Links zu allen Paketen, Codes und Dokumenten der Azure SDK-Bibliothek.