Obter Conjunto de Competências (API REST da Pesquisa de IA do Azure)
A operação Obter Conjunto de Competências obtém a definição do conjunto de competências da Pesquisa de IA do Azure. Um conjunto de competências é uma cadeia de competências, ligada por mapeamentos de entrada-saída, que efetua melhoramentos durante a indexação para tornar o conteúdo não processado pesquisável em texto completo num serviço de pesquisa
GET https://[service name].search.windows.net/skillsets/[skillset name]?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 devolver. |
| 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 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. Obter pedidos para uma definição de objeto tem de incluir um campo de chave de api definido para a sua chave de administrador (por 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
Nenhum.
Resposta
Código de Estado: 200 OK é devolvido para uma resposta com êxito. A resposta é semelhante a exemplos em Criar Conjunto de Competências
Nota
Se o conjunto de competências tiver uma chave de encriptação, o serviço de pesquisa tem de ter acesso à chave de encriptação para obter a definição do conjunto de competências. Sem acesso à chave de encriptação, é devolvido um Pedido Incorreto 400. Restaurar o acesso à chave permite que o serviço de pesquisa recupere novamente a definição do conjunto de competências.