http_request 插件

适用于:✅Azure 数据资源管理器

http_request 插件发送 HTTP GET 请求并将响应转换为表。

先决条件

  • 运行 .enable plugin http_request启用插件
  • 标注策略中将要访问的 URI 设置为 webapi 的允许目标

语法

evaluate http_request ( Uri [, RequestHeaders [, 选项]] )

详细了解语法约定

参数

客户 类型​​ 必需 说明
Uri string ✔️ HTTP 或 HTTPS 请求的目标 URI。
RequestHeaders dynamic 一个包含要随请求一起发送的 HTTP 标头的属性包。
选项 dynamic 一个包含请求的附加属性的属性包。

注意

  • 若要指定一个跟在可选参数之后的可选参数,请确保为前面的可选参数提供一个值。 有关详细信息,请参阅使用可选参数
  • 如果使用身份验证,则请使用 HTTPS 协议。 尝试将 HTTP 与身份验证结合使用会导致错误。

身份验证和授权

若要进行身份验证,请使用 HTTP 标准 Authorization 标头或 Web 服务支持的任何自定义标头。

注意

如果查询包含机密信息,请确保对查询文本的相关部分进行模糊处理,以便在任何跟踪中省略它们。 有关详细信息,请参阅经过模糊处理的字符串文本

返回

此插件返回一个表,该表有单条记录,其中包含以下动态列:

  • ResponseHeaders:一个包含响应标头的属性包。
  • ResponseBody:分析为 dynamic 类型值的响应正文。

如果 HTTP 响应指示(通过 Content-Type 响应标头)媒体类型为 application/json,则会自动对响应正文进行分析,就像它是 JSON 对象一样。 否则会将它按原样返回。

标头

RequestHeaders 参数可用于将自定义标头添加到传出的 HTTP 请求。 除了标准 HTTP 请求标头和用户提供的自定义标头之外,该插件还添加以下自定义标头:

名称 说明
x-ms-client-request-id 用于标识请求的相关 ID。 在同一查询中多次调用该插件都将使用同一 ID。
x-ms-readonly 一个标志,指示此请求的处理器不应做出任何永久性更改。

警告

为插件发送的、由查询而非管理命令触发的每个 HTTP 请求设置 x-ms-readonly 标志。 Web 服务应将具有此标志的任何请求视为不会做出内部状态更改的请求,否则它们应拒绝该请求。 这可以防止向用户发送看似无害的查询,但攻击者最终可以使用 Kusto 查询做出恶意的更改,以此作为此类攻击的发射台。

示例

以下示例检索 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
chinaeast2 数据见解 USD 2022-06-01T00:00:00Z false 欧洲西部 8ce915f7-20db-564d-8cc3-5702a7c952ab 数据见解报告消耗 DZH318Z08M22 Azure Purview 数据映射 0.21 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/006C Catalog Insights 0 消耗 1 API 调用 0.21
chinaeast2 数据映射扩充 - 数据见解生成 USD 2022-06-01T00:00:00Z false 欧洲西部 7ce2db1d-59a0-5193-8a57-0431a10622b6 数据映射扩充 - 数据见解生成 vCore DZH318Z08M22 Azure Purview 数据映射 0.82 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/005C 数据映射扩充 - 见解生成 0 消耗 1 小时 0.82
chinaeast2 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
chinaeast2 USD 2021-09-28T00:00:00Z false 欧洲西部 a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 资源集 vCore DZH318Z08M22 Azure Purview 数据映射 0.21 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/000X 资源集 0 消耗 1 小时 0.21
chinaeast2 USD 2021-09-28T00:00:00Z false 欧洲西部 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server vCore DZH318Z08M23 Azure Purview 扫描引入和分类 0 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 消耗 1 小时 0
chinaeast2 USD 2021-09-28T00:00:00Z false 欧洲西部 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 标准容量单位 DZH318Z08M22 Azure Purview 数据映射 0.411 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/0002 标准 0 消耗 1 小时 0.411
chinaeast2 USD 2021-09-28T00:00:00Z false 欧洲西部 811e3118-5380-5ee8-a5d9-01d48d0a0627 标准 vCore DZH318Z08M23 Azure Purview 扫描引入和分类 0.63 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/0009 标准 0 消耗 1 小时 0.63