你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

http_request 插件

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

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

先决条件

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

语法

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

详细了解语法约定

参数

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

注意

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

身份验证和授权

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

注意

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

返回

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

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

如果 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)

输出

armRegion名称 armSkuName 货币代码 生效开始日期 isPrimaryMeterRegion 位置 meterId 计量名称 productId 产品名称 零售价 serviceFamily 服务 serviceId 服务 ID 服务名称 skuId 的 SKU名称 tierMinimumUnits 类型 计量单位 单价
欧洲西部 数据见解 美元 2022-06-01T00:00:00Z 欧洲西部 8CE915F7-20DB-564D-8CC3-5702A7C952AB 数据见解报告消耗 DZH318Z08M22 Azure Purview 数据映射 0.21 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/006C 目录洞察 0 消耗 1 API 调用 0.21
欧洲西部 数据映射扩充 - 数据见解生成 美元 2022-06-01T00:00:00Z 欧洲西部 7CE2DB1D-59A0-5193-8A57-0431A10622B6 数据映射扩充 - 数据见解生成 vCore DZH318Z08M22 Azure Purview 数据映射 0.82 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/005C 数据映射扩充 - 见解生成 0 消耗 1 小时 0.82
欧洲西部 美元 2021-09-28T00:00:00Z 欧洲西部 053E2DCB-82C0-5E50-86CD-1F1C8D803705 Power BI vCore DZH318Z08M23 Azure Purview 扫描引入和分类 0 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 消耗 1 小时 0
欧洲西部 美元 2021-09-28T00:00:00Z 欧洲西部 a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 资源集 vCore DZH318Z08M22 Azure Purview 数据映射 0.21 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/000 倍 资源集 0 消耗 1 小时 0.21
欧洲西部 美元 2021-09-28T00:00:00Z 欧洲西部 5D157295-441C-5EA7-BA7C-5083026DC456 SQL Server vCore DZH318Z08M23 Azure Purview 扫描引入和分类 0 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 消耗 1 小时 0
欧洲西部 美元 2021-09-28T00:00:00Z 欧洲西部 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 标准容量单位 DZH318Z08M22 Azure Purview 数据映射 0.411 分析 DZH318Q66D0F Azure Purview DZH318Z08M22/0002 标准 0 消耗 1 小时 0.411
欧洲西部 美元 2021-09-28T00:00:00Z 欧洲西部 811e3118-5380-5ee8-a5d9-01d48d0a0627 标准 vCore DZH318Z08M23 Azure Purview 扫描引入和分类 0.63 分析 DZH318Q66D0F Azure Purview DZH318Z08M23/0009 标准 0 消耗 1 小时 0.63