Azure Data Factory Pipelines API无法应用筛选条件问题求助

几个可能的原因和解决办法 #

1. 筛选参数格式不对 #

ADF的REST API对筛选参数的格式要求很严，别踩这些坑：

• 运行状态得用精确的枚举值：是InProgress（首字母大写，无空格），不是你写的in progress。
• 管道名称要完全匹配，大小写也不能错，还要用正确的OData筛选语法。

正确的请求示例：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/pipelineruns?api-version=2018-06-01&$filter=status eq 'InProgress' and pipelineName eq '你的管道名称'

2. 忘了加时间范围筛选 #

默认API只返回最近7天的运行记录，如果你的目标运行超出这个范围，自然查不到。手动加时间参数覆盖默认范围：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/pipelineruns?api-version=2018-06-01&$filter=status eq 'InProgress' and pipelineName eq '你的管道名称' and lastUpdatedAfter '2024-01-01T00:00:00Z' and lastUpdatedBefore '2024-06-01T00:00:00Z'

注意时间必须是ISO 8601的UTC格式，结尾要加Z。

3. 权限有隐性限制 #

就算你能拿到所有运行记录，某些筛选场景可能因为权限细节返回空：

• 确保你的账户/服务主体有Microsoft.DataFactory/factories/pipelineruns/read权限，且权限作用域覆盖目标数据工厂。
• 别用仅针对单个管道的权限，先换成数据工厂层级的读取权限试试。

4. API版本太旧 #

不同版本的ADF API对筛选语法的支持不一样，建议用最新的稳定版（目前是2018-06-01），旧版本可能不支持某些筛选组合。

5. 状态同步有延迟 #

ADF的运行状态更新可能有几秒到几分钟的延迟，要是你刚触发运行就调用API，状态还没同步成InProgress，等会儿再试就行。

内容的提问来源于stack exchange，提问作者Grevioos