Repor Competências (API REST de Pré-visualização)
Aplica-se a: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Importante
07-2023-01-Preview (sem alterações).
2021-04-30-Preview (sem alterações).
A Pré-visualização 2020-06-30 adiciona a API. Suporta melhoramentos em cache e cenários de reposição.
O pedido Repor Competências processa seletivamente uma ou mais competências na próxima execução do indexador. Para indexadores com a colocação em cache ativada, pode pedir explicitamente o processamento de atualizações de competências que o indexador não consegue detetar. Por exemplo, se fizer alterações externas, como revisões a uma competência personalizada, pode utilizar esta API para executar novamente a competência. As saídas, como um arquivo de conhecimento ou um índice de pesquisa, são atualizadas com dados reutilizáveis da cache e novos conteúdos de acordo com a competência atualizada.
Pode repor um conjunto de competências existente com um HTTP POST, especificando o nome do conjunto de competências a atualizar no URI do pedido.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parâmetros do URI
| Parâmetro | Description |
|---|---|
| nome do serviço | Obrigatório. Defina-o como o nome exclusivo definido pelo utilizador do seu serviço de pesquisa. |
| nome do conjunto de competências | Obrigatório. O URI do pedido especifica o nome do conjunto de competências a repor. |
| api-version | Obrigatório. A versão de pré-visualização atual é 2023-07-01-Preview. Veja Versões da API para obter mais versões. |
Cabeçalhos de 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 reposição têm de incluir um api-key cabeçalho definido para a chave de administrador (em oposição a uma chave de consulta). Veja Connect to Azure AI Search using key authentication (Ligar à Pesquisa de IA do Azure com a autenticação de chaves ) para obter detalhes. |
Corpo do Pedido
O corpo do pedido é uma matriz de nomes de competências.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Resposta
Código de Estado: 204 Sem Conteúdo para uma resposta com êxito.