http_request プラグイン

[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: Microsoft Fabric ✅ Azure Data Explorer ✅

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

前提条件

• .enable plugin http_requestを実行してプラグイン可能にする
• Callout ポリシーのwebapiの許可された宛先としてアクセスするように URI を設定する

構文

evaluate http_request ( Uri [,RequestHeaders [,Options]])

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

パラメーター

認証と権限承認

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

返品

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

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

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

ヘッダー

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

例

次の例では、西ヨーロッパの 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)

出力