Versioni delle API in Azure AI Search

Note

Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.

Azure AI Search implementa regolarmente gli aggiornamenti delle funzionalità. Talvolta, ma non sempre, questi aggiornamenti richiedono una nuova versione dell'API per mantenere la compatibilità con le versioni precedenti. Questa pubblicazione consente di controllare come e quando integrare gli aggiornamenti del servizio di ricerca nel codice.

Come regola, le API REST e le librerie client di Azure SDK vengono eseguite solo quando necessario, poiché può comportare un certo sforzo per aggiornare il codice per usare una nuova versione dell'API. Una nuova versione è necessaria solo se alcuni aspetti dell'API sono stati modificati in modo da interrompere la compatibilità con le versioni precedenti. Ciò può verificarsi in caso di correzioni alle funzionalità esistenti o di nuove funzionalità che modificano la superficie di attacco dell'API esistente.

Per altre informazioni sul percorso di deprecazione, vedere Ciclo di vita e criteri di supporto di Azure SDK.

Versioni deprecate

2023-07-01-preview è stato deprecato l'8 aprile 2024 e non è più supportato a partire dall'8 luglio 2024. Questa versione è stata la prima API REST che offre supporto per la ricerca vettoriale. Le versioni più recenti dell'API hanno una configurazione vettoriale diversa. Eseguire la migrazione a una versione più recente dell'API o a una versione più recente dell'SDK il prima possibile.

Versioni non più disponibili

A partire dal 15 ottobre 2020, le versioni API seguenti non sono più documentate o supportate:

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

Tutti gli SDK sono basati sulle versioni dell'API REST. Se una versione dell'API REST non è più disponibile, anche i pacchetti SDK basati su di esso vengono sospesi. Tutti gli SDK di Azure AI Search .NET precedenti a 3.0.0-rc sono ora obsoleti.

Se si dispone di codice che usa una versione non più disponibile, eseguire la migrazione a una versione più recente dell'API o a una versione più recente dell'SDK.

API REST

API REST	Collegamento
Servizio di ricerca (piano dati)	Vedere Versioni dell'API nel riferimento API REST.
Gestione delle ricerche (piano di controllo)	Vedere Versioni dell'API nel riferimento API REST.

Azure SDK per .NET

Versione dell'SDK	Stato	Registro delle modifiche	Descrizione
Azure. Search.Documents 12	Attivo	Changelog	API per le operazioni del piano dati in un servizio, ad esempio operazioni di lettura/scrittura su contenuti e oggetti.
Azure. ResourceManager.Search	Attivo	Changelog	API per le operazioni del piano di controllo nel servizio di ricerca.

Azure SDK per Java

Versione dell'SDK	Stato	Registro delle modifiche	Descrizione
azure-search-documents 12	Attivo	Changelog	Usare la libreria client azure-search-documents per le operazioni del piano dati.
azure-resourcemanager-search 2	Attivo	Changelog	Usare la libreria client azure-resourcemanager-searchper le operazioni del piano di controllo.

Azure SDK per JavaScript

Versione dell'SDK	Stato	Registro delle modifiche	Descrizione
@azure/search-documents 13	Attivo	Changelog	Usare la libreria client @azure/search-documents per le operazioni del piano dati.
@azure/arm-search 4	Attivo	Changelog	Usare il pacchetto @azure/arm-search per le operazioni del piano di controllo.

Azure SDK per Python

Versione dell'SDK	Stato	Registro delle modifiche	Descrizione
azure-search-documents 12	Attivo	Changelog	Usare la libreria client azure-search-documents per le operazioni del piano dati.
azure-mgmt-search 9	Attivo	Log delle modifiche	Usare la libreria client azure-mgmt-searchper le operazioni del piano di controllo.

Tutti i Azure SDK

Se si cercano librerie client beta e documentazione, questa pagina contiene collegamenti a tutti i pacchetti, il codice e la documentazione della libreria Azure SDK.