plug-in http_request

  • Artigo

O http_request plug-in envia um pedido HTTP GET e converte a resposta numa tabela.

Pré-requisitos

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
Uri string ✔️ O URI de destino para o pedido HTTP ou HTTPS.
RequestHeaders dynamic Um saco de propriedades com cabeçalhos HTTP para enviar com o pedido.
Opções dynamic Um saco de propriedades que contém propriedades adicionais do pedido.

Nota

  • Para especificar um parâmetro opcional que siga um parâmetro opcional, certifique-se de que fornece um valor para o parâmetro opcional anterior. Para obter mais informações, veja Trabalhar com parâmetros opcionais.
  • Se estiver a utilizar a autenticação, utilize o protocolo HTTPS. As tentativas de utilização de HTTP com autenticação resultam num erro.

Autenticação e autorização

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

Nota

Se a consulta incluir informações confidenciais, certifique-se de que as partes relevantes do texto da consulta são ocultadas para que sejam omitidas de qualquer rastreio. Para obter mais informações, veja literais de cadeias obsultas.

Devoluções

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

  • ResponseHeaders: um saco 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 Content-Type cabeçalho de resposta) que o tipo de suporte de dados é application/json, o corpo da resposta é analisado automaticamente como se fosse um objeto JSON. Caso contrário, é devolvido tal como está.

Cabeçalhos

O argumento RequestHeaders pode ser utilizado para adicionar cabeçalhos personalizados ao pedido HTTP de saída. Além dos cabeçalhos de pedido HTTP padrão e dos cabeçalhos personalizados fornecidos pelo utilizador, o plug-in também adiciona os seguintes cabeçalhos personalizados:

Nome Descrição
x-ms-client-request-id Um ID de correlação que identifica o pedido. Várias invocações do plug-in na mesma consulta terão o mesmo ID.
x-ms-readonly Um sinalizador que indica que o processador deste pedido não deve fazer alterações persistentes.

Aviso

O x-ms-readonly sinalizador está definido para cada pedido HTTP enviado pelo plug-in que foi acionado por uma consulta e não por um comando de gestão. Os serviços Web devem tratar todos os pedidos com este sinalizador como um que não faça alterações de estado internos, caso contrário, devem recusar o pedido. Isto protege os utilizadores de serem enviados consultas aparentemente inocentes que acabam por fazer alterações indesejadas através de uma consulta Kusto como o launchpad para esses ataques.

Exemplo

O exemplo seguinte obtém os preços de revenda 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

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion localização meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits tipo unitOfMeasure unitPrice
westeurope Informações de Dados USD 2022-06-01T00:00:00Z false EU Oeste 8ce915f7-20db-564d-8cc3-5702a7c952ab Consumo de Relatórios do Data Insights DZH318Z08M22 Mapa de Dados do Azure Purview 0.21 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/006C Informações do Catálogo 0 Consumo 1 Chamadas à API 0.21
westeurope Melhoramento do Mapa de Dados – Geração de Informações de Dados USD 2022-06-01T00:00:00Z false EU Oeste 7ce2db1d-59a0-5193-8a57-0431a10622b6 Melhoramento do Mapa de Dados - Data Insights Generation vCore DZH318Z08M22 Mapa de Dados do Azure Purview 0.82 Análise DZH318Q66D0F Azure Purview DZH318Z08M22/005C Melhoramento do Mapa de Dados – Geração de Informações 0 Consumo 1 Hora 0.82
westeurope USD 2021-09-28T00:00:00Z false EU Oeste 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Ingestão e Classificação de Análise 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 EU Oeste 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 EU Oeste 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server vCore DZH318Z08M23 Ingestão e Classificação de Análise 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 EU Oeste 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 EU Oeste 811e3118-5380-5ee8-a5d9-01d48d0a0627 VCore Padrão DZH318Z08M23 Ingestão e Classificação de Análise do Azure Purview 0.63 Análise DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Consumo 1 Hora 0.63

Esta capacidade não é suportada no Azure Monitor.