Partilhar via


Índices de Lista (API REST da Pesquisa de IA do Azure)

A operação Índices de Lista devolve uma lista dos índices atualmente no seu Serviço de pesquisa de IA do Azure.

GET https://[service name].search.windows.net/indexes?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.
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.

Exemplos

{  
  "value": [  
    {  
      "name": "Books",  
      "fields": [  
        {"name": "ISBN", ...},  
        ...  
      ]  
    },  
    {  
      "name": "Games",  
      ...  
    },  
    ...  
  ]  
}  

Pode filtrar a resposta apenas para as propriedades que lhe interessam. Por exemplo, se quiser apenas uma lista de nomes de índice, utilize a opção consulta OData $select :

GET /indexes?api-version=2020-06-30&$select=name  

Neste caso, a resposta do exemplo acima seria apresentada da seguinte forma:

{  
  "value": [  
    {"name": "Books"},  
    {"name": "Games"},  
    ...  
  ]  
}  

Esta é uma técnica útil para guardar a largura de banda se tiver muitos índices no seu Serviço de pesquisa.

Ver também