使用Bicep配置Azure APIM后端时遇HTTPS协议不支持错误

可能的原因及修复方案 #

• API版本兼容性问题：你使用的2023-05-01-preview预览版API存在协议校验的bug，建议切换到稳定版API（比如2024-05-01），修改后重试：

  resource backend_test 'Microsoft.ApiManagement/service/backends@2024-05-01' = {
    name: 'backend_test'
    parent: apimservice 
    properties: {
        url: api_url
        protocol: 'https'
        // credentials: {
        //     authorization: {
        //         parameter: 'query'
        //         scheme: 'basic'
        //     }
        // }
    }
  }
  

• URL格式校验问题：确保api_url变量是标准HTTPS格式（例如https://example.com/api），URL格式不规范会触发协议不匹配的校验错误。

• 隐式协议推断冲突：当URL包含https://前缀时，部分APIM版本会自动推断协议，此时显式设置protocol: 'https'可能触发校验冲突。可以尝试注释掉protocol字段，让系统从URL自动推断：

  resource backend_test 'Microsoft.ApiManagement/service/backends@2023-05-01-preview' = {
    name: 'backend_test'
    parent: apimservice 
    properties: {
        url: api_url
        // protocol: 'https'
        // credentials: {
        //     authorization: {
        //         parameter: 'query'
        //         scheme: 'basic'
        //     }
        // }
    }
  }
  

验证步骤 #

1. 确认api_url格式正确，直接访问该URL确保HTTPS可正常连通。
2. 切换到稳定版API版本后重新部署，检查是否仍报错。
3. 移除protocol字段，依赖URL自动推断协议，测试部署结果。

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