Partilhar via

plugin de solicitação HTTP

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

O http_request plugin envia uma solicitação HTTP GET e converte a resposta em uma tabela.

Pré-requisitos

Sintaxe

evaluate http_request ( Uri [,RequestHeaders [,Opções]] )

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Uri string ✔️ O URI de destino para a solicitação HTTPS.
RequestHeaders dynamic Um pacote de propriedades contendo cabeçalhos HTTP para enviar com a solicitação.
Opções dynamic Um saco de propriedades contendo propriedades adicionais da solicitação.

Observação

  • Para especificar um parâmetro opcional que segue um parâmetro opcional, certifique-se de fornecer um valor para o parâmetro opcional anterior. Para obter mais informações, consulte Trabalhando com parâmetros opcionais.
  • Use sempre o protocolo HTTPS. Tentativas de usar HTTP com autenticação resultam em um erro.

Autenticação e autorização

Para autenticar, use o cabeçalho padrão Authorization HTTP ou qualquer cabeçalho personalizado suportado pelo serviço Web.

Observação

Se a consulta incluir informações confidenciais, certifique-se de que as partes relevantes do texto da consulta sejam ofuscadas para que sejam omitidas de qualquer rastreamento. Para obter mais informações, consulte literais de cadeia de caracteres ofuscadas.

Devoluções

O plug-in retorna uma tabela que tem um único registro com as seguintes colunas dinâmicas:

  • ResponseHeaders: um conjunto de propriedades com o cabeçalho de resposta.
  • ResponseBody: O corpo da resposta analisado como um valor do tipo dynamic.

Se a resposta HTTP indicar (através do cabeçalho de Content-Type resposta) que o tipo de mídia é application/json, o corpo da resposta será analisado automaticamente as-if for um objeto JSON. Caso contrário, ele será retornado as-is.

Cabeçalhos

O argumento RequestHeaders pode ser usado para adicionar cabeçalhos personalizados à solicitação HTTP de saída. Além dos cabeçalhos de solicitação HTTP padrão e dos cabeçalhos personalizados fornecidos pelo usuário, o plug-in também adiciona os seguintes cabeçalhos personalizados:

Nome Descrição
x-ms-client-request-id Uma ID de correlação que identifica a solicitação. Várias invocações do plugin na mesma consulta terão todas o mesmo ID.
x-ms-readonly Um sinalizador indicando que o processador dessa solicitação não deve fazer alterações persistentes.

Advertência

O x-ms-readonly sinalizador é definido para cada solicitação HTTP enviada pelo plug-in que foi acionada por uma consulta e não por um comando de gerenciamento. Os serviços da Web devem tratar quaisquer solicitações com esse sinalizador como uma solicitação que não faz alterações internas de estado, caso contrário, eles devem recusar a solicitação. Isso protege os usuários de serem enviados consultas aparentemente inocentes que acabam fazendo alterações indesejadas usando uma consulta Kusto como a plataforma de lançamento para tais ataques.

Exemplo

O exemplo a seguir recupera os preços de varejo do Azure para o Azure Purview na Europa Ocidental:

let Uri = "https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Azure Purview' and location eq 'EU West'";
evaluate http_request(Uri)
| project ResponseBody.Items
| mv-expand ResponseBody_Items
| evaluate bag_unpack(ResponseBody_Items)

Realização

armRegionName armSkuName código da moeda dataDeInícioEfetiva isPrimaryMeterRegion localização meterId nome do medidor productId Nome do produto preço de retalho serviçoFamília serviceId nomeDoServiço skuId nome do SKU tierMinimumUnits tipo unidadeDeMedida preço unitário
Europa Ocidental Insights de dados USD 2022-06-01T00:00:00Z falso EU Oeste 8ce915f7-20db-564d-8cc3-5702a7c952ab Consumo do relatório Data Insights DZH318Z08M22 Mapa de Dados do Azure Purview 0.21 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M22/006C Informações do catálogo 0 Consumo 1 Chamadas de API 0.21
Europa Ocidental Enriquecimento de Mapa de Dados - Geração de Insights de Dados USD 2022-06-01T00:00:00Z falso EU Oeste 7ce2db1d-59a0-5193-8a57-0431a10622b6 Enriquecimento de Mapa de Dados - Geração de Insights de Dados vCore DZH318Z08M22 Mapa de Dados do Azure Purview 0.82 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M22/005C Enriquecimento de Mapa de Dados - Geração de Insights 0 Consumo Uma Hora 0.82
Europa Ocidental USD 2021-09-28T00:00:00Z falso EU Oeste 053E2DCB-82C0-5E50-86CD-1F1C8D803705 Power BI vCore DZH318Z08M23 Ingestão e classificação de varredura do Azure Purview 0 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Consumo Uma Hora 0
Europa Ocidental USD 2021-09-28T00:00:00Z falso EU Oeste a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Conjunto de recursos vCore DZH318Z08M22 Mapa de Dados do Azure Purview 0.21 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M22/000X Conjunto de recursos 0 Consumo Uma Hora 0.21
Europa Ocidental USD 2021-09-28T00:00:00Z falso EU Oeste 5D157295-441C-5EA7-BA7C-5083026DC456 SQL Server vCore DZH318Z08M23 Ingestão e classificação de varredura do Azure Purview 0 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M23/000F Servidor SQL 0 Consumo Uma Hora 0
Europa Ocidental USD 2021-09-28T00:00:00Z falso EU Oeste 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Unidade de capacidade padrão DZH318Z08M22 Mapa de Dados do Azure Purview 0.411 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Padrão 0 Consumo Uma Hora 0.411
Europa Ocidental USD 2021-09-28T00:00:00Z falso EU Oeste 811e3118-5380-5ee8-a5d9-01d48d0a0627 vCore padrão DZH318Z08M23 Ingestão e classificação de varredura do Azure Purview 0,63 Análises de Dados DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Padrão 0 Consumo Uma Hora 0,63
  • Last updated on