Versioni API in Azure AI Search

2025-01-18

Il servizio Azure AI Search distribuisce regolarmente 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 vengono usate 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 sarà supportato dopo l'8 luglio 2024.

Si tratta della prima API REST che offre supporto per la ricerca vettoriale. Le versioni più recenti dell'API hanno una configurazione vettoriale diversa. È consigliabile eseguire la migrazione a una versione più recente il prima possibile.

Versioni non più disponibili

Alcune versioni dell'API non sono più disponibili e vengono rifiutate da un servizio di ricerca:

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 REST non è più disponibile, anche i pacchetti SDK basati su tale versione vengono sospesi. Tutti gli SDK .NET di Azure AI Search precedenti alla versione 3.0.0-rc sono ora obsoleti.

Il supporto per le versioni elencate sopra è terminato il 15 ottobre 2020. Se si dispone di codice che usa una versione non più disponibile, è possibile eseguire la migrazione del codice esistente a una versione più recente dell'API REST o a un SDK di Azure più recente.

API REST

REST API	Collega
Servizio di ricerca (piano dati)	Vedere Le versioni dell'API nelle informazioni di riferimento sulle API REST
Gestione (piano di controllo)	Vedere le versioni dell'API nelle informazioni di riferimento sulle API REST

Azure SDK per .NET

La tabella seguente fornisce collegamenti a versioni più recenti dell'SDK.

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

Azure SDK per Java

Versione dell'SDK	Status	Registro modifiche	Descrizione
azure-search-documents 11	Attive	Change Log Usare la libreria client per le `azure-search-documents` operazioni del piano dati.
azure-resourcemanager-search 2	Attive	Registro delle modifiche	Usare la libreria client `azure-resourcemanager-search`per le operazioni del piano di controllo.

Azure SDK per JavaScript

Versione dell'SDK	Status	Registro modifiche	Descrizione
@azure/documenti di ricerca 12	Attive	Registro delle modifiche	Usare la libreria client `@azure/search-documents` per le operazioni del piano dati.
@azure/ricerca arm 4	Attive	Registro delle modifiche	Usare il pacchetto per le operazioni del `@azure/arm-search` piano di controllo.

Azure SDK per Python

Versione dell'SDK	Status	Registro modifiche	Descrizione
azure-search-documents 11	Attive	Registro delle modifiche	Usare la libreria client `azure-search-documents` per le operazioni del piano dati.
azure-mgmt-search 9	Attive	Registro delle modifiche	Usare la libreria client `azure-mgmt-search`per le operazioni del piano di controllo.

Tutti gli SDK di Azure

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