Azure Data Factory：判断管道运行状态及queryPipelineRuns API返回空数组问题

• 时间范围筛选错误：API要求必填lastUpdatedAfter和lastUpdatedBefore参数，若时间范围设置过窄（比如仅覆盖几分钟），或者时间格式不符合ISO 8601标准（缺失时区信息，如未带Z后缀），会导致匹配不到已运行的管道实例。需确保时间范围覆盖管道实际运行时段，格式示例：2024-05-01T00:00:00Z。
• 资源名称拼写不一致：检查请求中pipelineName是否与已发布管道完全一致（区分大小写），同时确认URL中的资源组名称、数据工厂名称拼写无误。名称不匹配会导致查询范围错误，返回空结果。
• 权限不足：调用API的账号（服务主体或用户）缺少Data Factory Contributor或Monitoring Reader权限时，即便API返回200状态码，也无法读取运行记录，因此返回空数组。需在Azure RBAC中验证权限配置。
• 运行记录同步延迟：已发布触发器触发管道后，运行状态可能存在短暂的同步延迟，若立即调用API查询，记录尚未写入，就会返回空数组。可等待3-5分钟后重试。
• 筛选条件逻辑冲突：同时使用多个矛盾的筛选条件（比如同时指定status为InProgress和Failed），或条件指向不存在的资源（比如pipelineName输入错误），会导致无匹配实例。建议先单条件测试，再组合筛选条件。
• API版本适配问题：虽然使用的2018-06-01版本是稳定版，但部分环境下可能存在兼容性问题，可尝试切换到较新的稳定版本（如2021-06-01）测试是否能返回数据。
• 运行记录已被清理：管道运行实例默认保留45天，若手动清理过记录或实例已超过保留期限，运行记录会被移除，API无法返回已删除的内容。可检查数据工厂的运行保留设置确认。

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