Compartilhar via

http_request plugin

  • Artigo

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

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

Pré-requisitos

Sintaxe

evaluatehttp_request ( uri [ , RequestHeaders [, Opções]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
Uri string ✔️ O URI de destino para a solicitação HTTP ou HTTPS.
Cabeçalhos de solicitação dynamic Um recipiente de propriedades contendo cabeçalhos HTTP a serem enviados com a solicitação.
Opções dynamic Um recipiente de propriedades que contém 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.
  • Se você estiver usando autenticação, use o protocolo HTTPS. As 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, verifique se as partes relevantes do texto da consulta estão ofuscadas para que sejam omitidas de qualquer rastreamento. Para obter mais informações, consulte literais de cadeia de caracteres ofuscados.

Devoluções

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

  • ResponseHeaders: um recipiente 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 (por meio do cabeçalho de Content-Type resposta) que o tipo de mídia é application/json, o corpo da resposta será analisado automaticamente como se fosse um objeto JSON. Caso contrário, ele será retornado no estado em que se encontra.

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 plug-in na mesma consulta terão o mesmo ID.
x-ms-readonly Um sinalizador indicando que o processador dessa solicitação não deve fazer alterações persistentes.

Aviso

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 Web devem tratar todas as solicitações com esse sinalizador como uma que não faz alterações de estado internas, caso contrário, eles devem recusar a solicitação. Isso protege os usuários de receberem consultas aparentemente inocentes que acabam fazendo alterações indesejadas usando uma consulta Kusto como plataforma de lançamento para esses 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)

Saída

nome_da_região nome_sku currencyCode effectiveStartDate isPrimaryMeterRegion local meterId meterName productId productName varejoPreço serviceFamily serviceId serviceName skuId skuName tierMinimumUnits tipo unitOfMeasure unitPrice
westeurope Insights sobre os dados USD 2022-06-01T00:00:00Z false Oeste da Europa 8ce915f7-20db-564d-8cc3-5702a7c952ab Consumo de relatório do Data Insights DZH318Z08M22 Mapa de Dados do Azure Purview 0,21 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/006C Insights do catálogo 0 Consumo 1 Chamadas de API 0,21
westeurope Enriquecimento do Mapa de Dados - Geração de Insights de Dados USD 2022-06-01T00:00:00Z false Oeste da Europa 7ce2db1d-59a0-5193-8a57-0431a10622b6 Enriquecimento do Mapa de Dados - Data Insights Generation vCore DZH318Z08M22 Mapa de Dados do Azure Purview 0,82 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/005C Enriquecimento do Mapa de Dados - Geração de Insights 0 Consumo 1 hora 0,82
westeurope USD 2021-09-28T00:00:00Z false Oeste da Europa 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Ingestão e classificação de verificação do Azure Purview 0 Análise DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Consumo 1 hora 0
westeurope USD 2021-09-28T00:00:00Z false Oeste da Europa a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Conjunto de recursos vCore DZH318Z08M22 Mapa de Dados do Azure Purview 0,21 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/000X Conjunto de Recursos 0 Consumo 1 hora 0,21
westeurope USD 2021-09-28T00:00:00Z false Oeste da Europa 5D157295-441C-5EA7-BA7C-5083026DC456 SQL Server vCore DZH318Z08M23 Ingestão e classificação de verificação do Azure Purview 0 Análise DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Consumo 1 hora 0
westeurope USD 2021-09-28T00:00:00Z false Oeste da Europa 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Unidade de capacidade padrão DZH318Z08M22 Mapa de Dados do Azure Purview 0.411 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Consumo 1 hora 0.411
westeurope USD 2021-09-28T00:00:00Z false Oeste da Europa 811e3118-5380-5ee8-a5d9-01d48d0a0627 vCore padrão DZH318Z08M23 Ingestão e classificação de verificação do Azure Purview 0.63 Análise DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Consumo 1 hora 0.63