API-Versionen in Azure KI-Suche

Note

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Azure KI-Suche stellt regelmäßig Funktionsupdates bereit. 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 werden die REST-APIs und Azure SDK Clientbibliotheken nur bei Bedarf versionsiert, da sie einige Anstrengungen erfordern kann, den Code auf die Verwendung einer neuen API-Version zu aktualisieren. 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 zum Veralterungspfad finden Sie unter Lebenszyklus- und Support-Richtlinie des Azure-SDKs.

Veraltete Versionen

2023-07-01-Preview wurde am 8. April 2024 veraltet und wird ab dem 8. Juli 2024 nicht mehr unterstützt. Diese Version war die erste REST-API, die Vektorsuchunterstützung bot. Neuere API-Versionen weisen eine andere Vektorkonfiguration auf. Migrieren Sie so bald wie möglich zu einer neueren API-Version oder zu einer neueren SDK-Version.

Nicht mehr unterstützte Versionen

Ab dem 15. Oktober 2020 werden die folgenden API-Versionen nicht mehr dokumentiert oder unterstützt:

  • 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-API-Version nicht mehr vorhanden ist, werden die darauf basierenden SDK-Pakete ebenfalls nicht mehr unterstützt. Alle Azure KI-Suche .NET SDKs, die älter als 3.0.0-rc sind, gelten jetzt als veraltet.

Wenn Sie über Code verfügen, der eine nicht mehr vorhandene Version verwendet, migrieren Sie zu einer neueren API-Version oder zu einer neueren SDK-Version.

REST-APIs

REST-API Link
Suchdienst (Datenebene) Siehe API-Versionen in der REST-API-Referenz.
Suchverwaltung (Steuerungsebene) Siehe API-Versionen in der REST-API-Referenz.

Azure SDK für .NET

SDK-Version Status Änderungsprotokoll BESCHREIBUNG
Azure. Search.Documents 12 Aktiv Changelog APIs für Vorgänge auf Datenebene in einem Dienst, z. B. Lese-/Schreibvorgänge für Inhalte und Objekte
Azure. ResourceManager.Search Aktiv Änderungsprotokoll APIs für Vorgänge auf Steuerungsebene im Suchdienst

Azure SDK für Java

SDK-Version Status Änderungsprotokoll BESCHREIBUNG
azure-search-documents 12 Aktiv Changelog Verwenden Sie die azure-search-documents-Clientbibliothek für Datenebenenvorgänge.
azure-resourcemanager-search 2 Aktiv Changelog Verwenden Sie die azure-resourcemanager-search-Clientbibliothek für Steuerungsebenenvorgänge.

Azure SDK für JavaScript

SDK-Version Status Änderungsprotokoll BESCHREIBUNG
@azure/Suchdokumente 13 Aktiv Changelog Verwenden Sie die @azure/search-documents-Clientbibliothek für Datenebenenvorgänge.
@azure/arm-search 4 Aktiv Changelog Verwenden Sie das Paket @azure/arm-search für Vorgänge auf Steuerungsebene.

Azure SDK für Python

SDK-Version Status Änderungsprotokoll BESCHREIBUNG
azure-search-documents 12 Aktiv Changelog Verwenden Sie die azure-search-documents-Clientbibliothek für Datenebenenvorgänge.
azure-mgmt-search 9 Aktiv Changelog Verwenden Sie die azure-mgmt-search-Clientbibliothek für Steuerungsebenenvorgänge.

Alle Azure SDKs

Wenn Sie nach Betaclientbibliotheken und -dokumentationen suchen, enthält diese Seite Links zu allen Azure SDK Bibliothekspaketen, Code und Dokumenten.