Referência da API REST de gerenciamento (Azure AI Search)
As APIs REST de Gerenciamento do Azure AI Search (anteriormente conhecidas como Azure Cognitive Search) fornecem acesso programático a operações administrativas:
- Criar, atualizar e excluir um serviço de pesquisa
- Recuperar informações do serviço de pesquisa
- Criar, regenerar ou recuperar
api-keys
(chaves de consulta ou de administrador) - Adicionar ou remover réplicas e partições (ajustar a capacidade)
- Configurar um serviço de pesquisa para usar um ponto de extremidade privado
- Habilitar ou desabilitar o controle de acesso baseado em função do Azure
Para tarefas do plano de dados, como criar e consultar um índice, use as APIs REST do Serviço de Pesquisa.
Para administrar totalmente seu serviço programaticamente, você trabalha com duas APIs: a API REST de Gerenciamento do Azure AI Search documentada aqui, além da API REST comum do Azure Resource Manager. A API Resource Manager é usada para operações de uso geral que não são específicas do serviço, como consultar dados de assinatura, listar localizações geográficas e assim por diante.
Documentos da API com controle de versão
Os documentos da API REST agora têm controle de versão. Ao abrir uma página de referência de API, selecione a versão da API no filtro suspenso.
Permissões e controle de acesso
Os direitos de administração são transmitidos por meio de funções internas no Microsoft Entra ID:
- As atribuições de proprietário ou colaborador são necessárias para a maioria das tarefas.
- A função leitor tem acesso limitado a informações de serviço (operações GET, exceto para chaves de API que exigem permissões de Proprietário ou Colaborador).
Para obter mais informações, consulte Controle de acesso baseado em função no Azure AI Search.
Uma prática recomendada é atribuir funções a grupos em vez de usuários individuais. Um proprietário de assinatura do Azure ou administrador global gerencia essas atribuições. Para obter mais informações, confira Atribuir funções do Microsoft Entra a grupos.
Conectar-se ao ponto de extremidade de gerenciamento
Ao configurar a conexão, comece com o ponto de extremidade https://management.azure.com
Resource Manager e adicione a ID da assinatura, o provedor (Microsoft.Search
) e a versão da API. As operações são especificadas no corpo da solicitação.
Um ponto de extremidade totalmente especificado tem os seguintes componentes:
https://management.azure.com/subscriptions/[subscriptionId]/resourceGroups/[resourceGroupName]/providers/Microsoft.Search/searchServices/[serviceName]?api-version=2020-08-01
Os seguintes clientes geralmente são usados para chamar as APIs REST de gerenciamento:
Você também pode gerenciar um serviço de pesquisa usando o portal do Azure.
APIs de gerenciamento em outros SDKs
As APIs REST são fundamentais para o Azure AI Search e todas as alterações no modelo de programação são refletidas primeiro nas APIs REST.
As alternativas incluem os seguintes SDKs do Azure, que são atualizados independentemente em agendas de lançamento separadas:
- Biblioteca de clientes de gerenciamento do Microsoft Azure AI Search para .NET
- SDK do Microsoft Azure para Python
- Biblioteca de clientes do Gerenciamento do Azure Search para JavaScript
- Biblioteca de clientes do Azure Resource Manager AZure AI Search para Java