Versões da API no Azure AI Search

O Azure AI Search lança atualizações de recursos regularmente. Às vezes, mas nem sempre, essas atualizações exigem uma nova versão da API para preservar a compatibilidade com versões anteriores. A publicação de uma nova versão permite controlar quando e como integrar as atualizações do serviço de pesquisa no seu código.

Como regra, as APIs e bibliotecas REST são versionadas apenas quando necessário, uma vez que pode envolver algum esforço para atualizar seu código para usar uma nova versão da API. Uma nova versão só será necessária se algum aspeto da API tiver sido alterado de uma forma que quebre a compatibilidade com versões anteriores. Essas alterações podem acontecer devido a correções em recursos existentes ou devido a novos recursos que alteram a área de superfície da API existente.

Consulte Ciclo de vida e política de suporte do SDK do Azure para obter mais informações sobre o caminho de descontinuação.

Versões preteridas

2023-07-01-preview foi preterido em 8 de abril de 2024 e não será suportado após 8 de julho de 2024.

Esta foi a primeira API REST que ofereceu suporte à pesquisa vetorial. As versões mais recentes da API têm uma configuração vetorial diferente. Você deve migrar para uma versão mais recente o mais rápido possível.

Versões descontinuadas

Algumas versões da API são descontinuadas e rejeitadas por um serviço de pesquisa:

• 2015-02-28
• 2015-02-28-Pré-visualização
• 2014-07-31-Pré-visualização
• 2014-10-20-Pré-visualização

Todos os SDKs são baseados em versões da API REST. Se uma versão REST for descontinuada, os pacotes SDK baseados nessa versão também serão descontinuados. Todos os SDKs do Azure AI Search .NET mais antigos que 3.0.0-rc agora estão obsoletos.

O suporte para as versões listadas acima terminou em 15 de outubro de 2020. Se você tiver um código que usa uma versão descontinuada, poderá migrar o código existente para uma versão mais recente da API REST ou para um SDK do Azure mais recente.

APIs REST

API REST	Ligação
Serviço de Pesquisa (plano de dados)	Consulte as versões da API na referência da API REST
Gestão (plano de controlo)	Consulte as versões da API na referência da API REST

SDK do Azure para .NET

A tabela a seguir fornece links para versões mais recentes do SDK.

Versão do SDK	Status	Registo de alterações	Description
Azure.Search.Documents 11	Ativos	Registo de Alterações	APIs para operações de plano de dados em um serviço, como operações de leitura-gravação em conteúdo e objetos.
Azure.ResourceManager.Search	Ativos	Registo de Alterações	APIs para operações de plano de controle no serviço de pesquisa.

SDK do Azure para Java

Versão do SDK	Status	Registo de alterações	Description
azure-search-documents 11	Ativos	Log de alterações Use a biblioteca do azure-search-documents cliente para operações de plano de dados.
azure-resourcemanager-search 2	Ativos	Registo de Alterações	Use a biblioteca de cliente para operações de azure-resourcemanager-search plano de controle.

SDK do Azure para JavaScript

Versão do SDK	Status	Registo de alterações	Description
@azure/Pesquisar documentos 12	Ativos	Registo de Alterações	Use a biblioteca de @azure/search-documents cliente para operações de plano de dados.
@azure/busca por braço 4	Ativos	Registo de Alterações	Use o pacote para operações de @azure/arm-search controle do avião.

SDK do Azure para Python

Versão do SDK	Status	Registo de alterações	Description
azure-search-documents 11	Ativos	Registo de Alterações	Use a biblioteca de azure-search-documents cliente para operações de plano de dados.
azure-mgmt-search 9	Ativos	Registo de Alterações	Use a biblioteca de cliente para operações de azure-mgmt-search plano de controle.

Todos os SDKs do Azure

Se você estiver procurando por bibliotecas de cliente beta e documentação, esta página contém links para todos os pacotes, código e documentos da biblioteca do SDK do Azure.