Indexador de Atualizações (API REST da Pesquisa de IA do Azure)

  • Artigo

Pode atualizar uma definição de indexador existente com um pedido HTTP PUT. Especifique o nome do indexador a atualizar no URI do pedido:

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]  
    Content-Type: application/json  
    api-key: [admin key]

A atualização de uma definição de indexador não é executada automaticamente, mas, dependendo das modificações e da origem de dados associada, poderá ser necessária uma reposição e nova execução.

Parâmetros do URI

Parâmetro Description
nome do serviço Obrigatório. Defina-o como o nome exclusivo e definido pelo utilizador do seu serviço de pesquisa.
nome do indexador Obrigatório. O URI do pedido especifica o nome do indexador a atualizar.
api-version Obrigatório. A versão estável atual é api-version=2020-06-30. Veja Versões da API para obter mais versões.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Campos Description
Content-Type Obrigatório. Defina esta opção como application/json
api-key Opcional se estiver a utilizar funções do Azure e for fornecido um token de portador no pedido, caso contrário, é necessária uma chave. Uma chave de api é uma cadeia exclusiva gerada pelo sistema que autentica o pedido no seu serviço de pesquisa. Os pedidos de atualização têm de incluir um api-key cabeçalho definido para a sua chave de administrador (em oposição a uma chave de consulta). Veja Ligar à Pesquisa de IA do Azure com a autenticação de chaves para obter detalhes.

Corpo do Pedido

A sintaxe do corpo do pedido é a mesma que para Criar Indexador.

Ao atualizar um indexador existente, toda a definição é substituída pelo conteúdo do corpo do pedido. Em geral, o melhor padrão a utilizar para atualizações é obter a definição do indexador com um GET, modificá-la e, em seguida, atualizá-la com PUT.

Resposta

Para um pedido bem-sucedido: 201 Criado se um novo indexador tiver sido criado e 204 Sem Conteúdo se um indexador existente tiver sido atualizado.

Ver também