API-Versionen in der kognitiven Azure-Suche
Für die kognitive Azure-Suche 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 unterstützt wird, wird jedes SDK, das darauf basiert, ebenfalls eingestellt. Alle Azure Cognitive Search .NET SDKs, die älter als 3.0.0-rc sind, werden jetzt eingestellt.
Die Unterstützung für die oben aufgeführten Versionen werden am 15. Oktober 2020 eingestellt. 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 | Retired | 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 | Aktiv | 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 | Neue Clientbibliothek aus dem Azure Java SDK, veröffentlicht im Juli 2020. Gilt für die Such-REST-API, api-version=2019-05-06. |
| Java Management Client 1.35.0 | Aktiv | Gilt für die Management REST-API, api-version=2015-08-19. |
Azure SDK für JavaScript
| SDK-Version | Status | Beschreibung |
|---|---|---|
| JavaScript @azure/search-documents 11.0 | Aktiv | Neue Clientbibliothek aus dem Azure JavaScript SDK und TypesScript SDK, veröffentlicht im Juli 2020. Gilt für die Such-REST-API, api-version=2016-09-01. |
| JavaScript @azure/arm-search | Aktiv | Gilt für die Management REST-API, api-version=2015-08-19. |
Azure SDK für Python
| SDK-Version | Status | BESCHREIBUNG |
|---|---|---|
| Python azure-search-documents 11.0 | Aktiv | Neue Clientbibliothek aus dem Azure Python SDK, veröffentlicht im Juli 2020. Gilt für die Such-REST-API, api-version=2019-05-06. |
| Python azure-mgmt-search 8.0 | Aktiv | Gilt für die Management REST-API, api-version=2015-08-19. |
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.