Share via


Excluir Índice (API REST do Azure AI Search)

A operação Excluir Índice remove permanentemente um índice e seu conteúdo do serviço Pesquisa de IA do Azure. Essa operação é definitiva, sem opção de recuperação. Verifique se você tem uma cópia mestra do código de definição de índice, do código de ingestão de dados e um backup da fonte de dados externa no caso de uma rebuild ser necessário.

DELETE https://[service name].search.windows.net/indexes/[index name]?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin key]  

Se você tentar excluir um índice mapeado atualmente para um alias, a operação falhará com 400 (Solicitação Inválida) e uma mensagem de erro informando que o alias(es) mapeado para esse índice deve ser excluído ou mapeado para um índice diferente antes que o índice possa ser excluído.

Parâmetros de URI

Parâmetro Descrição
nome do serviço Obrigatórios. Defina isso como o nome exclusivo definido pelo usuário do serviço de pesquisa.
nome do índice Obrigatórios. O URI de solicitação especifica o nome do índice a ser excluído.
api-version Obrigatórios. A versão estável atual é api-version=2020-06-30. Consulte Versões de API para obter mais versões.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação necessários e opcionais

Campos Descrição
Tipo de conteúdo Obrigatórios. Defina-o como application/json
chave de API Opcional se você estiver usando funções do Azure e um token de portador for fornecido na solicitação, caso contrário, uma chave será necessária. Uma chave de api é uma cadeia de caracteres exclusiva gerada pelo sistema que autentica a solicitação para o serviço de pesquisa. As solicitações de exclusão devem incluir um api-key cabeçalho definido como sua chave de administrador (em vez de uma chave de consulta). Confira Conectar-se ao Azure AI Search usando a autenticação de chave para obter detalhes.

Corpo da solicitação

Nenhum.

Resposta

Código de status: 204 Sem Conteúdo é retornado para uma resposta bem-sucedida.

Confira também