次の方法で共有

http_request プラグイン

  • [アーティクル]

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

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

前提条件

構文

evaluatehttp_request ( Uri [, RequestHeaders [, Options]])

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

パラメーター

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

Note

  • 省略可能なパラメーターの後に省略可能なパラメーターを指定するには、前の省略可能なパラメーターの値を指定してください。 詳細については、「 省略可能なパラメーターを使用した作業を参照してください。
  • 認証を使用している場合は、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 type unitOfMeasure unitPrice
westeurope データ分析情報 米国ドル 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 データ マップ エンリッチメント - Data Insights の生成 米国ドル 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 米国ドル 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 米国ドル 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 米国ドル 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 米国ドル 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 米国ドル 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