Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
- Ejecución
.enable plugin http_requestpara habilitar el complemento - Establezca el URI para el acceso como destino permitido para
webapien la directiva de llamada.
Sintaxis
evaluate
http_request
(
Uri [ , RequestHeaders [,Options]])
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Uri | string |
✔️ | URI de destino de la solicitud 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.
- Use siempre 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 | código de moneda | fecha de inicio efectiva | isPrimaryMeterRegion | ubicación | meterId | nombre del medidor | ID de producto | ProductName | precio de venta al público | servicioFamilia | serviceId | nombreDelServicio | skuId | nombre del SKU | tierMinimumUnits | tipo | unidad de medida | precio unitario |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Europa Occidental | Información de datos | USD | 2022-06-01T00:00:00Z | falso | 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 |
| Europa Occidental | Enriquecimiento de mapa de datos: generación de Data Insights | USD | 2022-06-01T00:00:00Z | falso | 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 |
| Europa Occidental | USD | 2021-09-28T00:00:00Z | falso | 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 | |
| Europa Occidental | USD | 2021-09-28T00:00:00Z | falso | 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 | |
| Europa Occidental | USD | 2021-09-28T00:00:00Z | falso | 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 | |
| Europa Occidental | USD | 2021-09-28T00:00:00Z | falso | 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 | |
| Europa Occidental | USD | 2021-09-28T00:00:00Z | falso | 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 |