http_request プラグイン

  • [アーティクル]

プラグインは http_request HTTP GET 要求を送信し、応答をテーブルに変換します。

前提条件

構文

evaluatehttp_request(Uri [,RequestHeaders [,オプション]] )

構文規則について詳しく知る。

パラメーター

名前 型 必須 説明
Uri string ✔️ HTTP または HTTPS 要求の宛先 URI。
RequestHeaders dynamic 要求と共に送信する HTTP ヘッダー を含むプロパティ バッグ。
[オプション] dynamic 要求の追加のプロパティを含むプロパティ バッグ。

注意

  • 省略可能なパラメーターの後に省略可能なパラメーターを指定するには、前の省略可能なパラメーターの値を指定してください。 詳細については、「 省略可能なパラメーターの操作」を参照してください。
  • 認証を使用している場合は、HTTPS プロトコルを使用します。 認証で HTTP を使用しようとすると、エラーが発生します。

認証と承認

認証するには、HTTP 標準 Authorization ヘッダーまたは Web サービスでサポートされているカスタム ヘッダーを使用します。

Note

クエリに機密情報が含まれている場合は、クエリ テキストの関連部分が難読化され、トレースから省略されるようにしてください。 詳細については、「難読化文字列リテラル」を参照してください。

戻り値

プラグインは、次の動的列を持つ 1 つのレコードを持つテーブルを返します。

  • ResponseHeaders: 応答ヘッダーを含むプロパティ バッグ。
  • ResponseBody: 型 dynamicの値として解析される応答本文。

HTTP 応答が (応答ヘッダーを Content-Type 介して) メディアの種類が であることを示す場合、 application/json応答本文は JSON オブジェクトである場合、自動的にとして解析されます。 それ以外の場合は、そのまま返されます。

ヘッダー

RequestHeaders 引数を使用して、送信 HTTP 要求にカスタム ヘッダーを追加できます。 このプラグインは、標準の HTTP 要求ヘッダーとユーザー指定のカスタム ヘッダーに加えて、次のカスタム ヘッダーも追加します。

名前 説明
x-ms-client-request-id 要求を識別する関連付け ID。 同じクエリ内のプラグインの複数の呼び出しはすべて同じ ID を持ちます。
x-ms-readonly この要求のプロセッサが永続的な変更を行うべきではないことを示すフラグ。

警告

フラグは x-ms-readonly 、管理コマンドではなく、クエリによってトリガーされたプラグインによって送信されるすべての HTTP 要求に対して設定されます。 Web サービスは、このフラグを持つ要求を内部状態の変更を行わない要求として扱う必要があります。それ以外の場合は、要求を拒否する必要があります。 これにより、Kusto クエリをこのような攻撃のスタート パッドとして使用することで、一見無邪気なクエリがユーザーに送信され、不要な変更が行われるのを防げます。

例

次の例では、西ヨーロッパの Azure Purview の Azure 小売価格を取得します。

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 Catalog Insights 0 従量課金 1 つの API 呼び出し 0.21
westeurope データ マップ エンリッチメント - Data Insights の生成 USD 2022-06-01T00:00:00Z false 西ヨーロッパ 7ce2db1d-59a0-5193-8a57-0431a10622b6 データ マップ エンリッチメント - Data Insights Generation 仮想コア 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 仮想コア 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 Standard 仮想コア DZH318Z08M23 Azure Purview スキャンインジェストと分類 0.63 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 従量課金 1 時間 0.63

この機能については、Azure Monitor ではサポートされていません。