你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用于:✅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 |