如何修改Azure APIM URL路径中版本号的放置顺序
Azure APIM 版本号路径顺序调整方案
完全可以实现你要的baseUrl/v1/Product/Upload路径格式,有两种落地方式:
方案1:手动定义路径前缀(最简便)
直接放弃APIM内置的版本控制功能,创建API时将版本号作为URL后缀的前缀即可:
- 创建API时,将API URL后缀直接设置为
v1/Product,对应接口路径配置为Upload - 最终对外暴露的路径自动匹配
baseUrl/v1/Product/Upload的要求 - 后续迭代新版本时,直接新建后缀为
v2/Product的API即可自行管理版本迭代
方案2:保留内置版本控制+路径重写
如果需要使用APIM原生版本控制的版本切换、多版本共存等能力,可以搭配入站路径重写策略实现:
- 先按APIM默认规则创建带版本控制的API,此时默认路径为
baseUrl/Product/v1/Upload - 在API的入站策略中添加路径重写规则,将用户请求的
/v1/Product/*格式路径重写为APIM可识别的/Product/v1/*格式,示例策略如下:
<inbound> <rewrite-uri template="/Product/{version}/{restOfPath}" copy-unmatched-params="true" /> <base /> </inbound>
- 配置完成后用户端直接请求
baseUrl/v1/Product/Upload即可正常访问,不影响APIM原生版本控制功能的使用
小提示:方案2建议用正则匹配限定版本号为
v+数字的格式,避免和其他业务路径产生冲突。
内容的提问来源于stack exchange,提问作者venkatesh k
相关产品推荐
相关产品推荐

