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 será desativado em 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. Recomendamos migrar para uma versão mais recente o mais rápido possível.
Versões não suportadas
Algumas versões da API são descontinuadas e serão 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 | Description |
|---|---|---|
| Azure.Search.Documents 11 | Ativos | Nova biblioteca de cliente da equipe do SDK do Azure .NET, lançada inicialmente em julho de 2020. Consulte o Log de alterações para obter informações sobre versões secundárias. |
| Microsoft.Azure.Search 10 | Descontinuado | Lançado em maio de 2019. Esta é a última versão do pacote Microsoft.Azure.Search e agora foi preterida. Foi sucedido pelo Azure.Search.Documents. |
| Microsoft.Azure.Management.Search 4.0.0 | Ativos | Destina-se ao gerenciamento REST api-version=2020-08-01. |
| Microsoft.Azure.Management.Search 3.0.0 | Descontinuado | Destina-se ao gerenciamento REST api-version=2015-08-19. |
SDK do Azure para Java
| Versão do SDK | Status | Description |
|---|---|---|
| Java azure-search-documents 11 | Ativos | Use a biblioteca de azure-search-documents cliente para operações de plano de dados. |
| Cliente de Gerenciamento Java 1.35.0 | Ativos | Use a biblioteca de cliente para operações de azure-mgmt-search plano de controle. |
SDK do Azure para JavaScript
| Versão do SDK | Status | Description |
|---|---|---|
| JavaScript @azure/search-documents 11.0 | Ativo | Use a biblioteca de @azure/search-documents cliente para operações de plano de dados. |
| JavaScript @azure/arm-search | Ativos | Use a biblioteca de cliente para operações de @azure/arm-search plano de controle. |
SDK do Azure para Python
| Versão do SDK | Status | Description |
|---|---|---|
| Python azure-search-documents 11.0 | Ativos | Use a biblioteca de azure-search-documents cliente para operações de plano de dados. |
| Python azure-mgmt-search 8.0 | Ativos | 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.