Verwaltungs-REST-API-Versionen (Azure AI Search)
In diesem Artikel werden die aktuellen und früheren Versionen der Verwaltungs-REST-APIs für Azure AI Search aufgeführt.
Versionsierte API-Dokumente
REST-API-Dokumente sind jetzt versionsiert. Wenn Sie eine API-Referenzseite öffnen, wählen Sie die API-Version aus dem Dropdownfilter aus.
Stabile Versionen
| API-Version | Spezifikation | API-Updates |
|---|---|---|
2023-11-01 (neueste) |
Swagger Spezifikation | Versionshinweise |
2022-09-01 |
Swagger Spezifikation | Versionshinweise |
2020-08-01 |
Swagger Spezifikation | Versionshinweise |
2020-03-13 |
Swagger Spezifikation | Versionshinweise |
2015-08-19 |
Swagger Spezifikation | Versionshinweise |
Vorschauversionen
Vorschauversionen werden veröffentlicht, um neue Funktionen zu testen, Feedback zu sammeln und Probleme zu ermitteln und zu beheben. Vorschau-APIs sind unter Ergänzende Nutzungsbedingungenverfügbar und werden für Produktionsworkloads nicht empfohlen.
| API-Version | Spezifikation | API-Updates |
|---|---|---|
2024-06-01-Preview (neueste) |
Swagger Spezifikation | Versionshinweise |
2024-03-01-Preview |
Swagger Spezifikation | Versionshinweise |
2021-04-01-Preview |
Swagger Spezifikation | Versionshinweise |
2020-08-01-Preview |
Swagger Spezifikation | Versionshinweise |
2019-10-01-Preview |
Swagger Spezifikation | Versionshinweise |
Anmerkungen zur Version
2024-06-01-Preview
Diese Vorschauversion basiert auf der 2024-03-01-Preview Basislinie und fügt Unterstützung für einen neuen NetworkRuleSet.Bypass Wert namens AzureServiceshinzu. Sie können die Netzwerk-IP-Regeln umgehen, wenn Anforderungen von einem vertrauenswürdigen Dienst in Azure stammen. Die einzige andere Änderung besteht darin, die SearchService.ProvisioningState in Großbuchstaben umzubenennen (z. B. von "Erfolgreich" in "Erfolgreich").
2024-03-01-Preview
Diese Vorschauversion basiert auf der 2023-11-01 Basislinie und bietet Unterstützung für Netzwerksicherheitsperimeter.
2023-11-01
Diese allgemein verfügbare Version bietet die Möglichkeit, die semantische Rangfolge in Create or Update Service und Update Servicezu aktivieren oder zu deaktivieren.
2022-09-01
Diese allgemein verfügbare Version fügt Authentifizierungseigenschaften zu Create or Update Service und Update Servicehinzu.
Die Möglichkeit zum Aktivieren oder Deaktivieren rollenbasierten Zugriffssteuerung ist in dieser Version allgemein verfügbar.
2021-04-01-Preview
Diese Vorschau-API verfügt über alle Features der vorherigen Vorschau-API und fügt die folgenden Funktionen hinzu:
Vorschauunterstützung für rollenbasierte Zugriffssteuerung. Obwohl die Unterstützung für diese Aufgabe in
2022-09-01allgemein verfügbar ist, können Sie sie auch mit dieser Vorschau-API-Version aktivieren oder deaktivieren.Aktivieren oder deaktivieren Sie semantischen Such-. Die semantische Suche ist ein Premium-Feature, das auf Standardebenendiensten ausgeführt wird. Verwenden Sie in dieser REST-API für die Vorschauverwaltung Create or Update Services, um die semantische Suche auf Dienstebene zu deaktivieren, um jede Abfrage zu verbieten, die die semantische Rangfolge aufruft. Sie können dieses Feature auch für Suchdienste auf der kostenlosen Ebene für eine kleine Anzahl kostenloser Abfragen aktivieren.
Erzwingen Sie die Verschlüsselung von Datenebenenressourcen über vom Kunden verwaltete Schlüssel (Customer Managed Keys, CMK). Verwenden Sie Create or Update Services, um diese Option zu konfigurieren. Vorhandene Suchdienste, die diese Anforderung nicht erfüllen, werden als nicht konform gekennzeichnet.
Deaktivieren Sie Workloads, die Daten aus Azure AI Search an externe Ressourcen übertragen. Verwenden Sie Create or Update Services, um
properties.disabledDataExfiltrationOptionsauf "All" oder NULL (Standard) festzulegen. Durch das Deaktivieren aller Workloads werden die folgenden Funktionen deaktiviert:- Power Query-Connectors
- Debugsitzungen
- Anreicherungscache-
- Wissensspeicherund Skillsets im Allgemeinen, da sie benutzerdefinierte Fähigkeiten unterstützen, die in externen Code integriert werden.
2020-08-01-Preview
Diese Vorschau-API entspricht der allgemein verfügbaren Version 2020-08-01und fügt die folgenden Funktionen hinzu:
- Unterstützung für zwei neue Ressourcentypen wurde hinzugefügt
sharedPrivateLinkResources. NeuegroupIdWerte umfassenmysqlServer(Azure-Datenbank für MySQL) undsites(Azure Functions/App Services).
2020-08-01
Diese allgemein verfügbare Version wurde Ressourcen für freigegebene private Links Unterstützung für alle ressourcen mit ausgehendem Zugriff hinzugefügt, mit Ausnahme derjenigen, die in der Vorschauversion aufgeführt sind.
2020-03-13
Diese allgemein verfügbare Version hat Unterstützung für Private Endpoint Connections über Azure Private Link und Netzwerk-IP-Regeln für neue Dienste hinzugefügt.
2019-10-01-Preview
Dies ist die erste Vorschauversion. In dieser Liste wurden keine Vorschaufeatures eingeführt. Diese Vorschau entspricht funktional 2020-03-13. Es bleibt verfügbar. Jedes Skript oder Code, das diese Version aufruft, funktioniert, aber wir empfehlen Kunden, auf die Verwendung einer neueren API-Version (entweder eine allgemein verfügbare oder Vorschau-API-Version) zu aktualisieren, um dieselben Ergebnisse zu erhalten.
2015-08-19
Dies ist die erste Version der Verwaltungs-REST-API. Sie stellt APIs für die Diensterstellung und -löschung, Bereitstellung von Replikaten und Partitionen und die Verwaltung von API-Schlüsseln bereit.