Versões de API no Azure AI Search
O Azure AI Search lança atualizações de recursos regularmente. Às vezes, mas não 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 as atualizações de serviço de pesquisa são integradas ao seu código.
Como regra, as APIs e bibliotecas REST são versionadas somente quando necessário, pois isso pode envolver esforços para atualizar seu código, a fim de usar uma nova versão de API. Uma nova versão será necessária somente se alguns aspectos da API tiverem sido alterados de uma forma que interrompa a compatibilidade com versões anteriores. Essas alterações podem ocorrer devido a correções a recursos existentes ou devido a recursos novos que alteram a área da superfície da API existente.
Confira Ciclo de vida e política de suporte do SDK do Azure para obter mais informações sobre o caminho de descontinuidade.
Versões preteridas
A versão 2023-07-01-preview foi preterida em 8 de abril de 2024 e será desativada em 8 de julho de 2024. Essa foi a primeira API REST que ofereceu suporte à busca em vetores. As versões de API mais recentes têm uma configuração de vetores diferente. Recomendamos migrar para uma versão mais recente o mais cedo possível.
Versões sem suporte
Algumas versões de API são descontinuadas e serão rejeitadas por um serviço de pesquisa:
- 2015-02-28
- 2015-02-28-Preview
- 2014-07-31-Preview
- 2014-10-20-Preview
Todos os SDKs são baseados em versões da API REST. Se uma versão de REST for descontinuada, os pacotes do SDK baseados nessa versão serão descontinuados também. Todos os SDKs do .NET para a Pesquisa de IA do Azure anteriores à versão 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 da API REST mais recente ou para um SDK do Azure mais recente.
APIs REST
| API REST | Link |
|---|---|
| Serviço de Pesquisa (plano de dados) | Confira as versões da API na referência da API REST |
| Gerenciamento (painel de controle) | Confira 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 | Descrição |
|---|---|---|
| Azure.Search.Documents 11 | Ativa | Nova biblioteca de clientes da equipe do SDK do .NET do Azure, lançada incialmente em julho de 2020. Consulte o Log de alterações para obter informações sobre as versões secundárias. |
| Microsoft.Azure.Search 10 | Desativado | Lançamento em maio de 2019. Essa é a versão mais recente do pacote Microsoft.Azure.Search e não está preterida. Ela é sucedida pelo Azure.Search.Documents. |
| Microsoft.Azure.Management.Search 4.0.0 | Ativa | Destina-se à API REST de Gerenciamento api-version=2020-08-01. |
| Microsoft.Azure.Management.Search 3.0.0 | Desativado | Destina-se à API REST de Gerenciamento api-version=2015-08-19. |
SDK do Azure para Java
| Versão do SDK | Status | Descrição |
|---|---|---|
| Java azure-search-documents 11 | Ativa | Use a biblioteca de clientes azure-search-documents para as operações de plano de dados. |
| Cliente de gerenciamento de Java 1.35.0 | Ativa | Use a biblioteca de clientes azure-mgmt-search para as operações de plano de controle. |
SDK do Azure para JavaScript
| Versão do SDK | Status | Descrição |
|---|---|---|
| JavaScript @azure/search-documents 11.0 | Ativo | Use a biblioteca de clientes @azure/search-documents para as operações de plano de dados. |
| JavaScript @azure/arm-search | Ativa | Use a biblioteca de clientes @azure/arm-search para as operações de plano de controle. |
SDK do Azure para Python
| Versão do SDK | Status | Descrição |
|---|---|---|
| Python azure-search-documents 11.0 | Ativa | Use a biblioteca de clientes azure-search-documents para as operações de plano de dados. |
| Python azure-mgmt-search 8.0 | Ativa | Use a biblioteca de clientes azure-mgmt-search para as operações de plano de controle. |
Todos os SDKs do Azure
Se você estiver procurando bibliotecas de cliente beta e documentação, esta página contém links para todos os pacotes, códigos e documentos da biblioteca do SDK do Azure.