REST-API-Versionen der Datenebene (Azure AI Search)

In diesem Artikel werden die aktuellen und früheren Versionen der Search-REST-APIs für Azure AI Search aufgeführt.

Versionsierte API-Dokumente

REST-API-Dokumente sind jetzt versionsiert. Wenn Sie eine API-Referenzseite öffnen, wird oberhalb des Inhaltsverzeichnisses eine Versionsauswahl angezeigt. Der Selektor ist verfügbar, wenn Sie eine Seite aus dem Ordner "Reference > Data Plane " auswählen.

Stabile Versionen

Vorschauversionen

Alle neuen Funktionen werden in Vorschau-APIs eingeführt, bevor sie auf eine stabile Version umgestellt werden. Vorschau-APIs sind unter Ergänzende Nutzungsbedingungen für Microsoft Azure Previewsverfügbar.

Anmerkungen zur Version

2025-11-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2025-08-01-previewsich derzeit in der Vorschauphase befinden.

Wenn Sie den 2025-08-01-preview verwendet haben, um einen Wissensagenten zu erstellen, der inzwischen in Wissensdatenbank umbenannt wurde, werden in dieser Vorschau wichtige Änderungen eingeführt. Hilfe zur Migration finden Sie unter Migrieren von agentischem Abrufcode zur neuesten Version.

Weitere Informationen zu diesen Updates finden Sie unter Neuerungen in Azure AI Search.

2025-09-01

Diese API-Version ist die neueste stabile REST-API für Azure AI Search. Sie baut auf der vorherigen stabilen Version (2024-07-01) auf und fügt die API-Updates hinzu, die in der folgenden Tabelle aufgeführt sind.

Einige andere allgemein verfügbare Features, z. B. die Integration von Logic Apps und die Unterstützung semantischer Bewertungsprofile, wirken sich nicht auf den API-Vertrag aus und werden nicht in der Tabelle widergespiegelt. Eine vollständige Liste der Ankündigungen finden Sie unter Neuerungen in Azure AI Search .

2025-08-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2025-05-01-previewsich derzeit in der Vorschauphase befinden.

Wenn Sie den 2025-05-01-preview zum Erstellen eines Wissens-Agents verwendet haben, werden in dieser Vorschau wichtige Änderungen eingeführt. Hilfe zur Migration finden Sie unter Migrieren von agentischem Abrufcode zur neuesten Version.

Weitere Informationen zu diesen Updates finden Sie unter Neuerungen in Azure AI Search.

2025-05-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2025-03-01-previewsich derzeit in der Vorschauphase befinden. Sie können REST-API-Versionen2025-03-01-preview mit minimalen Codeänderungen von auf aktualisieren 2025-05-01-preview .

Diese Vorschauversion bietet Unterstützung für agentischen Abruf, multimodale Indizierung, Berechtigungsvererbung auf Dokumentebene und eine tiefere Integration mit großen Sprachmodellen sowohl bei Indizierungs- als auch bei Abfrageworkloads. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2025-03-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2024-11-01-previewsich derzeit in der Vorschauphase befinden. Sie können REST-API-Versionen2024-11-01-preview mit minimalen Codeänderungen von auf aktualisieren 2025-03-01-preview .

Es gibt nur wenige API-Updates auf Datenebene in dieser Vorschau, aber weitere Funktionen sind im Suchdienst verfügbar, wenn Ihr Code diese Vorschau-API-Version aufruft. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2024-11-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2024-09-01-previewsich derzeit in der Vorschauphase befinden. Sie können REST-API-Versionen2024-09-01-preview mit minimalen Codeänderungen von auf aktualisieren 2024-11-01-preview .

2024-09-01-preview

Diese Vorschauversion baut auf der auf und umfasst alle Funktionen, die 2024-05-01-previewsich derzeit in der Vorschauphase befinden. Sie können ein Upgrade von 2024-05-01-preview auf 2024-09-01-preview durchführen, ohne dass Codeänderungen erforderlich sind. Weitere Informationen finden Sie unter Upgrade der REST-APIs.

2024-07-01

Diese Version bietet allgemein verfügbare Updates für integrierte Vektorisierung (Fähigkeiten und Vektorisierer), skalare Quantisierung und binäre Quantisierung. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2024-05-01-preview

Diese Vorschau bietet Unterstützung für oneLake-Indizierung, Relevanzoptimierung und tiefere Integration mit mehr Einbettungsmodellen während der Indizierung und Abfragen. Es baut auf dem auf und umfasst alle Funktionen, die 2024-03-01-previewsich derzeit in der Vorschau befinden.

Um ein Upgrade von 2024-03-01-preview oder 2023-10-01-previewdurchzuführen, aktualisieren Sie die AzureOpenAIEmbedding-Fähigkeit oder den Vektorizer, um den Modellnamen und die Dimensionen einzuschließen. Informationen zum Upgrade von 2023-07-01-preview (veraltet) oder schrittweise Anleitungen finden Sie unter Upgrade-REST-APIs.

Hier sind die Updates in dieser Vorschau. Wir empfehlen auch Neuerungen in Azure AI Search.

2024-03-01-preview

Diese Vorschauversion baut auf 2023-10-01-preview auf, indem Vorschau-APIs hinzugefügt werden, die den Vektorspeicher verbessern. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2023-11-01

Diese Version bietet allgemein verfügbare Features. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2023-10-01-preview

Diese Version enthält alle Features, die in früheren Vorschauen eingeführt wurden, sowie Ergänzungen und Änderungen an Vektorsuch-APIs. Aktualisierungen der Vektorsuch-APIs sind eine bahnbrechende Änderung von 2023-07-01-Preview. Informationen zur Migrationshilfe finden Sie unter Hinzufügen von Vektorfeldern und Erstellen einer Vektorabfrage.

Wenn Sie die neue Vorfilterfunktion verwenden möchten, müssen Sie einen Index verwenden, der nach 2023-10-01erstellt wurde.

erstellen oder aktualisieren:

• vectorSearch enthält Definitionen für algorithms, profilesund vectorizers:

  • algorithms unterstützt weiterhin hnsw und unterstützt jetzt auch eknn, in Bezug auf hierarchische Navigable Small World (HNSW) und erschöpfende K-nächste Nachbarn (eKNN). Im Abschnitt "Algorithmus" können Sie mehrere benannte Kombinationen von HNSW- und eKNN-Parametern definieren. Dadurch wird algorithmConfigurations innerhalb der eigenschaft vectorSearch in 2023-07-01-Preview ersetzt.

  • profiles ist eine neue Definition, die die Algorithmuskonfiguration angibt. Angenommen, Sie haben Algorithmuskonfigurationen namens HNSW-1, HSNW-2, eKNN-1. Ein Profil kann HNSW-1 angeben.

  • vectorizers wird in einem Index definiert, aber zur Abfragezeit zum Einbetten einer Textabfragezeichenfolge verwendet. Ein Vektorisierer verweist auf ein Einbettungsmodell. Der Suchdienst ruft das Einbettungsmodell auf, um die Textabfragezeichenfolge zu vektorisieren, und übergibt das Ergebnis dann an die Suchmaschine für eine Vektorabfrage.

• Bei Vektorfeldern ersetzt vectorSearchProfilevectorSearchConfiguration. Die eigenschaft vectorSearchProfile gibt an, welches Vektorsuchprofil für das Feld verwendet werden soll.

• Bei Indizes, die vor dieser API-Version erstellt wurden, müssen Sie beim Aufrufen der API 2023-10-01-Preview in Ihrer Anforderung das Feld ändern, um eine vectorSearchProfile anzugeben, solange das Profil den genauen Algorithmus angibt, der zuvor in vectorSearchConfigurationangegeben wurde. Wenn beispielsweise die vorhandene Felddefinition "vectorSearchConfiguration": "myHnsw"angibt, müssen Sie sie durch "vectorSearchProfile": "your profile name"ersetzen, und das Profil muss definiert werden, um auf dasselbe "algorithm": "myHnsw"zu verweisen.

Dokumentedurchsuchen:

• vectorQueries ersetzt vectors in 2023-07-01-Preview
• vectorQueries.vectors ersetzt vectors.values in 2023-07-01-Preview.
• Die Vektorabfrage ist jetzt eine polymorphe Struktur. kind muss angegeben werden, um den Typ der angeforderten Vektorabfrage anzugeben. "kind": "vector" bedeutet, dass die Abfrage ein Vektor ist, sodass der Aufrufer die Suchabfragezeichenfolge bereits in eine Vektoreinbettung vektorisiert haben sollte.
• "exhaustive": "true" ist eine neue Eigenschaft gibt an, ob eine vollständige (brute-force) k-nächste Nachbarsuche über alle Vektoren im Vektorindex hinweg erfolgen soll.
• vectorFilterMode ist ein neuer Parameter zum Festlegen der Vorfilterung (Standard für Indizes, die nach erstellt wurden 2023-10-01) oder der Nachfilterung (Standard für vorherige Indizes) in der Abfrage.

Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2023-07-01-preview

Diese Version hat die Vektorunterstützung eingeführt und eine Vektorkonfiguration verwendet, die mit neueren API-Versionen nicht kompatibel ist.

• Ein Collection(Edm.Single) Datentyp für Felder hinzugefügt, die ein Array mit Gleitkommazahlen mit einfacher Genauigkeit enthalten. Dies ist der Datentyp für Vektoren, der zum Speichern einer generierten Einbettung pro Dokumentfeld verwendet wird. Der Suchindex gibt auch Vektorkonfigurationseigenschaften an.
• Die Indizierung von Workloads wurde aktualisiert, um Vektordaten zu akzeptieren.
• Abfrageparameter für die Vektorsuche hinzugefügt. Siehe Dokumente durchsuchen für diese Parameter.
• Get Service Statistics: Gibt das Vektorindexkontingent und die Nutzung für den Service zurück.
• Get Index Statistics: Gibt das Vektorindexkontingent und die Verwendung für den Suchindex zurück.
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2021-04-30-preview

Diese Vorschauversion enthält alle Features, die in 2020-06-30-Preview eingeführt wurden, sowie Ergänzungen zu den folgenden APIs:

• Der Indexalias fügt einen sekundären Namen hinzu, der zum Verweisen auf Indizes in Abfragen und Indizierungsanforderungen verwendet wird. Aliasvorgänge umfassen "Erstellen", "Aktualisieren", "Löschen", "Abrufen" und "Liste".
• Verwaltete Identitäten für ausgehende Verbindungen. Neue Werte für Verbindungszeichenfolgen in Datenquelle erstellen oder aktualisieren unterstützen Verbindungen mit Microsoft Entra ID-Authentifizierung und -Rollen anstelle von hartcodierten Datenbankanmeldeinformationen oder -schlüsseln.
• Die Unterstützung für verwaltete Identitäten wird auch für Schlüsseltresorverbindungen unterstützt, für Suchlösungen, die die Standardverschlüsselung mit vom Kunden verwalteten Verschlüsselungergänzen.
• Weitere Sprachen für die kognitive Fähigkeit zur Textübersetzung.
• Weitere queryLanguages für die semantische Suche und Rechtschreibprüfung in Search Documents.
• Ein captions-Parameter, um optional Untertitel aus der semantischen Suche in Search Documents anzufordern.
• Semantische Konfigurationen werden in Index erstellen oder aktualisieren angegeben. Eine semantische Konfiguration bestimmt, welche Felder für semantische Rangfolge, Beschriftungen, Hervorhebungen und Antworten verwendet werden sollen.
• Ein semanticConfiguration-Parameter, der für semantische Abfragen in Search Documents erforderlich ist.
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2020-06-30

Diese Version bietet allgemein verfügbare Features, einschließlich:

• Azure-rollenbasierte Zugriffssteuerung für Datenebenenvorgänge
• Relevanzbewertung (BM25)
• Wissensspeicher
• Indexer-Datenquelle für Azure Data Lake Storage (ADLS) Gen2
• Benutzerdefinierte Entitäts-Nachschlagefähigkeit
• Indexer, die unter einem System oder einer vom Benutzer verwalteten Identität über die Microsoft Entra-ID ausgeführt werden
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2020-06-30-preview

Diese Vorschauversion enthält alle Features, die in 2019-05-06-Preview eingeführt wurden, sowie die folgenden Ergänzungen:

• Semantische Suche, ein Premium-Feature, das auf Standardebenendiensten ausgeführt wird und die semantische Rangfolge aufruft.
• Indexer-Datenquelle für Power Query-Connectors
• Indexer-Datenquelle für MySQL
• Indexer-Datenquelle für Cosmos DB Gremlin-API
• Indexer-Datenquelle für SharePoint Online
• Normalizer-Eigenschaft für die Textnormalisierung, für Filterung, Faceting und Sortierung zwischen Groß- und Kleinschreibung
• Zurücksetzen von Dokumenten für indexerbasierte Indizierung, um bestimmte Dokumente anhand der ID speziell zu aktualisieren
• Kognitiver Skill „Entitätsverknüpfung“ (v3)
• Kognitive Fähigkeiten der Entitätserkennung (v3)
• Kognitive Fähigkeiten der Stimmungsanalyse (v3)
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2019-05-06-preview

• Unterstützung der Indexer-Datenquelle für Cosmos DB MongoDB-API
• Indexer-Datenquelle für vorläufiges Löschen im Blob Storage
• featuresMode-Parameter, der detaillierte Informationen zu einer Relevanzbewertung zurückgibt
• Kognitive Fähigkeiten von Azure Machine Learning (AML)
• Erkennung kognitiver Fähigkeiten
• Zwischenspeichern von erweiterten Dokumenten zum Beibehalten und Wiederverwenden der Bildverarbeitung (und anderer KI-Anreicherungen)
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

Siehe auch

• Erstellen eines Suchdiensts
• Schnellstart: Erstellen eines Azure AI Search-Index mithilfe von REST-APIs