Share via

http_request plugin

  • Artigo

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

Pré-requisitos

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Uri string ✔️ O URI de destino para a solicitação HTTP ou HTTPS.
RequestHeaders dynamic Um recipiente de propriedades que contém 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, forneça um valor para o parâmetro opcional anterior. Para obter mais informações, consulte Trabalhando com parâmetros opcionais.
  • Se você estiver usando a autenticação, use 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 compatível com o 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 elas sejam omitidas de qualquer rastreamento. Para obter mais informações, consulte literais de cadeia de caracteres ofuscados.

Retornos

O plug-in retorna uma tabela que tem 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 Content-Type cabeçalho de 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 modo 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 a mesma ID.
x-ms-readonly Um sinalizador que indica que o processador dessa solicitação não deve fazer nenhuma alteração persistente.

Aviso

O x-ms-readonly sinalizador é definido para cada solicitação HTTP enviada pelo plug-in que foi disparado 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 faça alterações de estado internas, 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 barra inicial para esses ataques.

Exemplo

O exemplo a seguir recupera os preços de varejo do Azure para o Azure Purview no oeste da Europa:

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

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion local meterId meterName productId productName retailPrice 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 à 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 – Geração de Insights de Dados 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

Não há suporte para essa funcionalidade no Azure Monitor.