http_request 插件
适用于:✅Azure 数据资源管理器
http_request
插件发送 HTTP GET 请求并将响应转换为表。
先决条件
语法
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 |