Azure APIM导入API文件时,如何解决无法解析指定文件的问题?

摘要:【Azure APIM】API导入功能报错 Unable to parse specified file. 问题描述 在APIM的API操作页面,为了备份API的所有配置信息,先使用导出功能把API导出为OpenAPI(YAML)文件。 但
【Azure APIM】API导入功能报错 Unable to parse specified file. 问题描述 在APIM的API操作页面,为了备份API的所有配置信息,先使用导出功能把API导出为OpenAPI(YAML)文件。 但诡异的是,紧接着把同样的文件导入时,却报错:Unable to parse specified file. Please ensure it is valid OpenAPI specification document. 当根据常规排查思路,打开浏览器开发者模式(F12),查看是否有Console Error,是否有Network Trace错误? 通过浏览器开发者工具(Console / Network)确认: 前端未抛出 JS 异常 后端未返回结构化错误信息 这基本可以判断:问题不在 Portal 前端逻辑,而更可能发生在服务端对文件内容的解析阶段。 导入报错截图: 面对这个问题,应该如何排查呢? 问题解答 这个问题,最让人迷惑的行为时:文件有API的导出功能生成,而马上用于导入时候,确报错说不是有效的OpenAPI文件格式。 于是,怀疑是APIM的门户出现了Bug。 为了绕过 Portal 的前端封装,直接验证 APIM 后端对 OpenAPI 文件的解析行为,使用 Azure CLI 进行 API 导入测试。 此处使用了az apim api import命令,来交叉验证问题。
阅读全文