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

Переключение служб с помощью раскрывающегося списка версий . Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer

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

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

Синтаксис

evaluate http_request ( Uri [ RequestHeaders,]]

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

Параметры

Имя (название) Тип Обязательно Описание
URI-адрес string ✔️ Целевой универсальный код ресурса (URI) для 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 Код валюты дата начала действия isPrimaryMeterRegion расположение meterId название счетчика productId названиеПродукта розничная цена сервисСемейный serviceId название сервиса skuId skuName tierMinimumUnits тип единица измерения цена за единицу
Западная Европа Аналитические сведения Доллары США 2022-06-01T00:00:00Z неправда Западная Европа 8CE915F7-20DB-564D-8CC3-5702A7C952AB Использование отчета Data Insights DZH318Z08M22 Схема данных Azure Purview 0.21 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/006С Аналитика каталогов 0 Потребление 1 вызовы API 0.21
Западная Европа Обогащение карты данных — создание аналитики данных Доллары США 2022-06-01T00:00:00Z неправда Западная Европа 7ce2db1d-59a0-5193-8a57-0431a10622b6 Обогащение карты данных — виртуальное ядро создания аналитики данных DZH318Z08M22 Схема данных Azure Purview 0.82 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/005С Обогащение карты данных — создание аналитических сведений 0 Потребление Час 0.82
Западная Европа Доллары США 2021-09-28T00:00:00Z неправда Западная Европа 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Виртуальные ядра Power BI DZH318Z08M23 Проверка Azure Purview и классификация 0 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Потребление Час 0
Западная Европа Доллары США 2021-09-28T00:00:00Z неправда Западная Европа a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Виртуальные ядра набора ресурсов DZH318Z08M22 Схема данных Azure Purview 0.21 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/000Х Набор ресурсов 0 Потребление Час 0.21
Западная Европа Доллары США 2021-09-28T00:00:00Z неправда Западная Европа 5d157295-441c-5ea7-ba7c-5083026dc456 Виртуальные ядра SQL Server DZH318Z08M23 Проверка Azure Purview и классификация 0 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/000Ф SQL Server 0 Потребление Час 0
Западная Европа Доллары США 2021-09-28T00:00:00Z неправда Западная Европа 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Единица емкости уровня "Стандартный" DZH318Z08M22 Схема данных Azure Purview 0.411 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Стандартные 0 Потребление Час 0.411
Западная Европа Доллары США 2021-09-28T00:00:00Z неправда Западная Европа 811e3118-5380-5ee8-a5d9-01d48d0a0627 Стандартное виртуальное ядро DZH318Z08M23 Проверка Azure Purview и классификация 0,63 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Стандартные 0 Потребление Час 0,63
  • Last updated on