Versões da API REST de Gestão (Pesquisa de IA do Azure)

  • Artigo

Este artigo lista as versões atuais e anteriores das APIs REST de Gestão do Azure AI Pesquisa.

Documentos da API com versão

Os documentos da API REST têm agora o controlo de versões. Quando abrir uma página de referência da API, selecione a versão da API no filtro pendente.

Captura de ecrã do seletor de versões.

Versões estáveis

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

Versões de pré-visualização

As versões de pré-visualização são lançadas para testar novas funcionalidades, recolher feedback e descobrir e corrigir problemas. As APIs de Pré-visualização estão disponíveis nos Termos de Utilização Suplementares e não são recomendadas para cargas de trabalho de produção.

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

Notas de versão

2024-03-01-Preview

Esta versão de pré-visualização adiciona suporte futuro para o perímetro de segurança de rede. Baseia-se na 2023-11-01 linha de base e fornece todas as APIs nessa versão. Veja um anúncio sobre o perímetro de segurança de rede em Novidades no Azure AI Pesquisa.

2023-11-01

Esta versão geralmente disponível adiciona a capacidade de ativar ou desativar a classificação semântica em Criar ou Atualizar Serviço e Atualizar Serviço.

2022-09-01

Esta versão geralmente disponível adiciona propriedades de autenticação a Criar ou Atualizar o Serviço e o Serviço de Atualização.

A capacidade de ativar ou desativar o controlo de acesso baseado em funções 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:

  • Pré-visualizar o suporte para o controlo de acesso baseado em funções. Embora o suporte para esta tarefa esteja geralmente disponível no 2022-09-01, também pode ativá-la ou desativá-la com esta versão da API de pré-visualização.

  • Ativar ou desativar a pesquisa semântica. A pesquisa semântica é uma funcionalidade premium que é executada nos serviços de escalão Standard. Nesta API REST de gestão de pré-visualização, utilize Criar ou Atualizar Serviços para desativar a pesquisa semântica ao nível do serviço para proibir qualquer consulta que invoque a classificação semântica. Também pode ativar esta funcionalidade nos serviços de pesquisa no escalão gratuito para um pequeno número de consultas gratuitas.

  • Impor a encriptação de recursos do plano de dados através de Chaves Geridas pelo Cliente (CMK). Utilize Criar ou Atualizar Serviços para configurar esta opção. Os serviços de pesquisa existentes que não cumpram este requisito são marcados como não conformes.

  • Desative as cargas de trabalho que enviam dados do Azure AI Pesquisa para recursos externos. Utilize Criar ou Atualizar Serviços para definir properties.disabledDataExfiltrationOptions como "Tudo" ou nulo (predefinição). Desativar todas as cargas de trabalho desativa as seguintes capacidades:

2020-08-01-Preview

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

  • Foi adicionado sharedPrivateLinkResources suporte para dois novos tipos de recursos. Os novos groupId valores incluem mysqlServer (base de dados do Azure para MySQL) e sites (Funções do Azure/serviços de aplicações).

2020-08-01

Esta versão geralmente disponível adicionou suporte de Recursos de Private Link Partilhados para todos os recursos acedidos de saída, exceto os indicados na versão de pré-visualização.

2020-03-13

Esta versão geralmente disponível adicionou suporte para Connections de Ponto Final Privado através de 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. Permanece disponível. Qualquer script ou código que chame essa versão irá funcionar, mas recomendamos que os clientes atualizem para a utilização de uma versão de API mais recente (uma versão da API geralmente disponível ou de pré-visualização) para obter os mesmos resultados.

2015-08-19

Esta é a versão inicial da API REST de Gestão. Forneceu APIs para criação e eliminação de serviços, aprovisionamento de réplicas e partições e gestão de chaves de API.

Ver também