Поделиться через

Подключаемый модуль http_request

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

Подключаемый http_request модуль отправляет HTTP-запрос GET и преобразует ответ в таблицу.

Необходимые компоненты

Синтаксис

evaluatehttp_request ( Uri [ RequestHeaders [, , Параметры]])

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
URI-адрес string ✔️ Целевой универсальный код ресурса (URI) для HTTP-запроса или HTTPS.
RequestHeaders dynamic Контейнер свойств, содержащий заголовки HTTP для отправки с запросом.
Параметры dynamic Контейнер свойств, содержащий дополнительные свойства запроса.

Примечание.

  • Чтобы указать необязательный параметр, который следует за необязательным параметром, обязательно укажите значение для предыдущего необязательного параметра. Дополнительные сведения см. в разделе "Работа с необязательными параметрами".
  • Если вы используете проверку подлинности, используйте протокол HTTPS. Попытки использования HTTP с проверкой подлинности приводят к ошибке.

Проверка подлинности и авторизация

Для проверки подлинности используйте стандартный Authorization заголовок HTTP или любой пользовательский заголовок, поддерживаемый веб-службой.

Примечание.

Если запрос содержит конфиденциальную информацию, убедитесь, что соответствующие части текста запроса скрыты, чтобы они были опущены из любой трассировки. Дополнительные сведения см. в скрытых строковых литералах.

Возвраты

Подключаемый модуль возвращает таблицу с одной записью со следующими динамическими столбцами:

  • ResponseHeaders: контейнер свойств с заголовком ответа.
  • ResponseBody: текст ответа, проанализированный как значение типа dynamic.

Если HTTP-ответ указывает (через Content-Type заголовок ответа), что тип носителя является application/json, текст ответа автоматически анализируется как если это объект JSON. В противном случае возвращается как есть.

Заголовки

Аргумент RequestHeaders можно использовать для добавления пользовательских заголовков в исходящий HTTP-запрос. Помимо стандартных заголовков HTTP-запросов и пользовательских заголовков, подключаемый модуль также добавляет следующие пользовательские заголовки:

Имя Описание
x-ms-client-request-id Идентификатор корреляции, определяющий запрос. Несколько вызовов подключаемого модуля в одном запросе будут иметь один и тот же идентификатор.
x-ms-readonly Флаг, указывающий, что обработчик этого запроса не должен вносить постоянные изменения.

Предупреждение

Флаг x-ms-readonly задается для каждого HTTP-запроса, отправленного подключаемым модулем, который был активирован запросом, а не командой управления. Веб-службы должны рассматривать любые запросы с этим флагом как те, которые не вносят внутренние изменения состояния, в противном случае они должны отказаться от запроса. Это защищает пользователей от отправки, казалось бы, невинных запросов, которые в конечном итоге вносят нежелательные изменения с помощью запроса Kusto в качестве панели запуска для таких атак.

Пример

В следующем примере извлекаются розничные цены Azure для Azure Purview в западной Европе:

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)

Выходные данные

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion расположение meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits type unitOfMeasure unitPrice
westeurope Аналитические сведения USD 2022-06-01T00:00:00Z false Западная Европа 8ce915f7-20db-564d-8cc3-5702a7c952ab Использование отчета Data Insights DZH318Z08M22 Схема данных Azure Purview 0.21 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/006C Аналитика каталогов 0 Потребление 1 вызовы API 0.21
westeurope Обогащение карты данных — создание аналитики данных USD 2022-06-01T00:00:00Z false Западная Европа 7ce2db1d-59a0-5193-8a57-0431a10622b6 Обогащение карты данных — виртуальное ядро создания аналитики данных DZH318Z08M22 Схема данных Azure Purview 0.82 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/005C Обогащение карты данных — создание аналитических сведений 0 Потребление Час 0.82
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Виртуальные ядра Power BI DZH318Z08M23 Проверка Azure Purview и классификация 0 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Потребление Час 0
westeurope USD 2021-09-28T00:00:00Z false Западная Европа a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Виртуальные ядра набора ресурсов DZH318Z08M22 Схема данных Azure Purview 0.21 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/000X Набор ресурсов 0 Потребление Час 0.21
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 5d157295-441c-5ea7-ba7c-5083026dc456 Виртуальные ядра SQL Server DZH318Z08M23 Проверка Azure Purview и классификация 0 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Потребление Час 0
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Единица емкости уровня "Стандартный" DZH318Z08M22 Схема данных Azure Purview 0.411 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Стандартные 0 Потребление Час 0.411
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 811e3118-5380-5ee8-a5d9-01d48d0a0627 Стандартное виртуальное ядро DZH318Z08M23 Проверка Azure Purview и классификация 0,63 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Стандартные 0 Потребление Час 0,63