Versões da API REST de gerenciamento (Azure AI Search)

Este artigo lista as versões atuais e passadas das APIs REST de Gerenciamento para o Azure AI Search.

Documentos de API versionados

Os documentos da API REST agora estão versionados. Ao abrir uma página de referência de API, selecione a versão da API no filtro suspenso.

Captura de tela do seletor de versão.

Versões estáveis

Versão da API Especificação Atualizações da API
2023-11-01 (Mais recente) Especificação Swagger Nota de lançamento
2022-09-01 Especificação Swagger Nota de lançamento
2020-08-01 Especificação Swagger Nota de lançamento
2020-03-13 Especificação Swagger Nota de lançamento
2015-08-19 Especificação Swagger Nota de lançamento

Versões de pré-visualização

As versões de pré-visualização são disponibilizadas para testar novas funcionalidades, recolher feedback e descobrir e corrigir problemas. As APIs de visualização estão disponíveis em Termos de Uso Suplementarese não são recomendadas para cargas de trabalho de produção.

Versão da API Especificação Atualizações da API
2024-06-01-Preview (Mais recente) Especificação Swagger Nota de lançamento
2024-03-01-Preview Especificação Swagger Nota de lançamento
2021-04-01-Preview Especificação Swagger Nota de lançamento
2020-08-01-Preview Especificação Swagger Nota de lançamento
2019-10-01-Preview Especificação Swagger Nota de lançamento

Notas de versão

2024-06-01-Preview

Esta versão de pré-visualização baseia-se na linha de base 2024-03-01-Preview e adiciona suporte para um novo valor de NetworkRuleSet.Bypass chamado AzureServices. Você pode ignorar as regras de IP de rede se as solicitações forem originadas de um serviço confiável no Azure. A única outra mudança é renomear o SearchService.ProvisioningState para maiúsculas (por exemplo, de sucedido para bem-sucedido).

2024-03-01-Preview

Esta versão de pré-visualização baseia-se na linha de base 2023-11-01 e adiciona suporte para perímetro de segurança de rede.

2023-11-01

Esta versão disponível em geral adiciona a capacidade de habilitar ou desabilitar de classificação semântica no Criar ou Atualizar Serviço e Update Service.

2022-09-01

Esta versão geralmente disponível adiciona propriedades de autenticação ao Create or Update Service e ao Update Service.

A capacidade de habilitar ou desabilitar de controle de acesso baseado em função está geralmente disponível nesta versão.

2021-04-01-Preview

Esta API de pré-visualização tem todas as funcionalidades da API de pré-visualização anterior e adiciona a seguinte funcionalidade:

  • Suporte de visualização para controle de acesso baseado em função. Embora o suporte para esta tarefa esteja geralmente disponível no 2022-09-01, você também pode habilitá-lo ou desativá-lo usando esta versão da API de visualização.

  • Ativar ou desativar pesquisa semântica. A pesquisa semântica é um recurso premium que é executado em serviços de camada padrão. Nesta API REST de gerenciamento de visualização, use Create ou Update Services para desabilitar a pesquisa semântica no nível de serviço para proibir qualquer consulta que invoque classificação semântica. Você também pode habilitar esse recurso em serviços de pesquisa no nível gratuito para um pequeno número de consultas gratuitas.

  • Imponha a criptografia de recursos do plano de dados por meio de de chaves gerenciadas pelo cliente (CMK). Use Criar ou Atualizar Serviços para configurar essa opção. Os serviços de pesquisa existentes que não atendem a esse requisito são marcados como não compatíveis.

  • Desative cargas de trabalho que enviam dados do Azure AI Search para recursos externos. Use Criar ou Atualizar Serviços para definir properties.disabledDataExfiltrationOptions como "Todos" ou nulo (padrão). A desativação de todas as cargas de trabalho desativa os seguintes recursos:

2020-08-01-Preview

Esta API de pré-visualização é equivalente à versão disponível em geral 2020-08-01e adiciona a seguinte funcionalidade:

  • Adicionado suporte sharedPrivateLinkResources para dois novos tipos de recursos. Os novos valores groupId incluem mysqlServer (banco de dados do Azure para MySQL) e sites (Azure Functions/serviços de aplicativo).

2020-08-01

Esta versão geralmente disponível adicionou Recursos de Link Privado Compartilhado suporte para todos os recursos acessados de saída, exceto aqueles observados na versão de visualização.

2020-03-13

Esta versão geralmente disponível adicionou suporte para Conexões de Ponto Final Privado por meio do Azure Private Link e regras de IP de rede para novos serviços.

2019-10-01-Preview

Esta é a primeira versão de pré-visualização. Não foram introduzidas funcionalidades de pré-visualização nesta lista. Esta pré-visualização é funcionalmente equivalente a 2020-03-13. Continua disponível. Qualquer script ou código que chame essa versão funcionará, mas recomendamos que os clientes atualizem para usar uma versão mais recente da API (uma versão da API Geralmente disponível ou uma versão da API de visualização) para obter os mesmos resultados.

2015-08-19

Esta é a versão inicial da API REST de gerenciamento. Ele fornecia APIs para criação e exclusão de serviços, provisionamento de réplicas e partições e gerenciamento de chaves de API.

Ver também