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

  • Статья

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

Предварительные требования

Синтаксис

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

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

Параметры

Имя Тип Обязательно Описание
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 location meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits тип 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 Обогащение карты данных — виртуальное ядро создания Data Insights DZH318Z08M22 Схема данных Azure Purview 0,82 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/005C Обогащение карты данных — создание аналитических сведений 0 Потребление 1 час 0,82
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Прием и классификация сканирования Azure Purview 0 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Потребление 1 час 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 Потребление 1 час 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 Потребление 1 час 0
westeurope USD 2021-09-28T00:00:00Z false Западная Европа 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Стандартная единица емкости DZH318Z08M22 Схема данных Azure Purview 0.411 Аналитика DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Потребление 1 час 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 Standard 0 Потребление 1 час 0.63

Эта возможность не поддерживается в Azure Monitor.