Compartir a través de

http_request plugin

  • Artículo

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

El http_request complemento envía una solicitud HTTP GET y convierte la respuesta en una tabla.

Requisitos previos

Sintaxis

evaluatehttp_request ( Uri [ , RequestHeaders [, Options]])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
Uri string ✔️ URI de destino para la solicitud HTTP o HTTPS.
RequestHeaders dynamic Contenedor de propiedades que contiene encabezados HTTP que se van a enviar con la solicitud.
Opciones dynamic Contenedor de propiedades que contiene propiedades adicionales de la solicitud.

Nota:

  • Para especificar un parámetro opcional que sigue a un parámetro opcional, asegúrese de proporcionar un valor para el parámetro opcional anterior. Para obtener más información, vea Trabajar con parámetros opcionales.
  • Si usa la autenticación, use el protocolo HTTPS. Los intentos de usar HTTP con la autenticación producen un error.

Autenticación y autorización

Para autenticarse, use el encabezado estándar Authorization HTTP o cualquier encabezado personalizado compatible con el servicio web.

Nota:

Si la consulta incluye información confidencial, asegúrese de que las partes pertinentes del texto de la consulta están ofuscadas para que se omitan de cualquier seguimiento. Para obtener más información, consulte literales de cadena ofuscados.

Devoluciones

El complemento devuelve una tabla que tiene un único registro con las siguientes columnas dinámicas:

  • ResponseHeaders: contenedor de propiedades con el encabezado de respuesta.
  • ResponseBody: el cuerpo de la respuesta analizado como un valor de tipo dynamic.

Si la respuesta HTTP indica (a través del Content-Type encabezado de respuesta) que el tipo de medio es , el cuerpo de la respuesta se analiza automáticamente como si fuera application/jsonun objeto JSON. De lo contrario, se devuelve tal y como está.

encabezados

El argumento RequestHeaders se puede usar para agregar encabezados personalizados a la solicitud HTTP saliente. Además de los encabezados de solicitud HTTP estándar y los encabezados personalizados proporcionados por el usuario, el complemento también agrega los siguientes encabezados personalizados:

Nombre Descripción
x-ms-client-request-id Identificador de correlación que identifica la solicitud. Todas las invocaciones múltiples del complemento en la misma consulta tendrán el mismo identificador.
x-ms-readonly Marca que indica que el procesador de esta solicitud no debe realizar ningún cambio persistente.

Advertencia

La x-ms-readonly marca se establece para cada solicitud HTTP enviada por el complemento desencadenado por una consulta y no por un comando de administración. Los servicios web deben tratar las solicitudes con esta marca como una que no realice cambios de estado interno; de lo contrario, deben rechazar la solicitud. Esto protege a los usuarios de que se envían consultas aparentemente inocentes que terminan realizando cambios no deseados mediante una consulta de Kusto como launchpad para estos ataques.

Ejemplo

En el ejemplo siguiente se recuperan los precios minoristas de Azure para Azure Purview en el oeste de 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)

Salida

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion ubicación meterId meterName productId ProductName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits type unitOfMeasure unitPrice
westeurope Data Insights USD 2022-06-01T00:00:00Z false Oeste de Europa 8ce915f7-20db-564d-8cc3-5702a7c952ab Consumo de informes de Data Insights DZH318Z08M22 Asignación de datos de Azure Purview 0,21 Análisis DZH318Q66D0F Azure Purview DZH318Z08M22/006C Información del catálogo 0 Consumo 1 llamadas API 0,21
westeurope Enriquecimiento de mapa de datos: generación de Data Insights USD 2022-06-01T00:00:00Z false Oeste de Europa 7ce2db1d-59a0-5193-8a57-0431a1a10622b6 Enriquecimiento de mapa de datos: núcleo virtual de generación de Data Insights DZH318Z08M22 Asignación de datos de Azure Purview 0.82 Análisis DZH318Q66D0F Azure Purview DZH318Z08M22/005C Enriquecimiento de mapa de datos: generación de conclusiones 0 Consumo 1 hora 0.82
westeurope USD 2021-09-28T00:00:00Z false Oeste de Europa 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Núcleo virtual de Power BI DZH318Z08M23 Ingesta y clasificación de análisis de Azure Purview 0 Análisis DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Consumo 1 hora 0
westeurope USD 2021-09-28T00:00:00Z false Oeste de Europa a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Núcleo virtual del conjunto de recursos DZH318Z08M22 Asignación de datos de Azure Purview 0,21 Análisis DZH318Q66D0F Azure Purview DZH318Z08M22/000X Conjunto de recursos 0 Consumo 1 hora 0,21
westeurope USD 2021-09-28T00:00:00Z false Oeste de Europa 5d157295-441c-5ea7-ba7c-5083026dc456 Núcleo virtual de SQL Server DZH318Z08M23 Ingesta y clasificación de análisis de Azure Purview 0 Análisis DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Consumo 1 hora 0
westeurope USD 2021-09-28T00:00:00Z false Oeste de Europa 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Unidad de capacidad estándar DZH318Z08M22 Asignación de datos de Azure Purview 0.411 Análisis DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Estándar 0 Consumo 1 hora 0.411
westeurope USD 2021-09-28T00:00:00Z false Oeste de Europa 811e3118-5380-5ee8-a5d9-01d48d0a0627 Núcleo virtual estándar DZH318Z08M23 Ingesta y clasificación de análisis de Azure Purview 0.63 Análisis DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Estándar 0 Consumo 1 hora 0.63