Azure Data Factory部署托管私有端点报Invalid payload错误求助
ADF托管私有端点CI/CD部署Invalid Payload报错排查方案
- 检查ARM模板属性缺失:你当前导出的托管私有端点定义仅包含
privateLinkResourceId和groupId两个属性,新版本Azure资源管理器要求补充fqdns属性,存储Blob场景下需在properties节点下添加如下配置:
"fqdns": [ "storccsurveydev001.blob.core.windows.net" ]
国内Azure环境需将域名后缀替换为core.chinacloudapi.cn。
- 更换ARM API版本:你当前使用的
2018-06-01版本API对托管私有端点的支持存在已知校验缺陷,将apiVersion字段替换为2023-01-01及以上稳定版本即可解决版本不兼容导致的payload校验失败问题。 - 校验依赖项定义正确性:确认模板中
factoryId变量的取值是否正确,正确定义应为[resourceId('Microsoft.DataFactory/factories', parameters('factoryName'))],变量错误会导致依赖顺序异常,私有端点创建时托管虚拟网络未就绪触发payload报错。 - 排查参数隐形异常:导出发布阶段实际使用的最终参数文件,逐字符核对
pe-ccsurvey-blob-001_properties_privateLinkResourceId取值,确认流水线参数覆盖环节没有带入换行、空格、不可见Unicode字符等异常内容。 - 手工对比校验:直接在目标环境Azure门户中手动创建同名托管私有端点,创建成功后导出对应的ARM模板,和CI/CD生成的模板逐行对比,可快速定位缺失的配置项。
内容的提问来源于stack exchange,提问作者Rob Bowman
相关产品推荐
相关产品推荐

