如何在Azure API Management服务中更新替换现有OpenAPI规范

你的猜测完全准确，针对你要更新现有Azure API Management（APIM）中OpenAPI 3.x规范的需求，直接选择导入入口下的Update选项即可，这就是专门对应覆盖更新现有API规范的功能，完全匹配你「同步新增端点、不新建重复API」的诉求。

操作避坑提示 #

• 选择Update导入新版YAML规范时，APIM会自动同步你新增的接口端点，同时会保留你之前在APIM侧给这个API、已有接口配置的自定义策略、产品绑定、访问权限等个性化配置，不会把你之前做的配置冲掉
• 不要误选Create选项：这个选项会把你上传的规范识别为全新API导入，最终会生成重复的API条目，不符合更新需求
• 导入时记得确认规范类型选择的是OpenAPI 3.0，和你原有规范的版本保持一致，避免格式识别出错导致接口配置异常
• 如果你的新版规范里移除了部分旧接口，Update导入完成后APIM会自动清理掉这些已经不存在的接口配置，不需要你手动逐个删除

小提示：刚导入更新的规范默认处于编辑状态，不会直接同步到线上发布版本，你可以核对完所有新增端点的配置、测试无误后再手动点击发布，不会影响现有线上服务的正常运行。

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