Azure API 管理 devops 资源工具包 - 创建者工具答案

【问题标题】：Azure API Management devops resource kit - creator toolAzure API 管理 devops 资源工具包 - 创建者工具
【发布时间】：2021-03-16 00:36:24
【问题描述】：

我正在使用 Azure API 管理 DevOps 资源工具包来生成用于在 DevOps 管道中配置我的 API 管理实例的 arm 模板

这适用于具有 swagger 定义的 API，但我有一个 WSDL，我也想使用相同的流程自动化它。关于如何使用 WSDL 文件而不是 swagger 文件来执行此操作，似乎没有很好的文档

我知道作为创建者使用的 config.yml 文件的一部分，您可以指定 type:soap 但它仍然需要您指向一个开放的 API 规范文件

这个过程可以用 WSDL 文件来执行吗？

【问题讨论】：

【解决方案1】：

您可以尝试在某处托管 WSDL 并从那里引用它。否则很容易导入。 https://docs.microsoft.com/en-us/azure/api-management/import-soap-api

但是，如果您要导入 API，您可能会遇到一些限制或发现需要纠正的问题，然后才能成功执行导入。

对于 WSDL，我们需要以下几点：

WSDL 文件用于创建 SOAP 传递和 SOAP-to-REST API。
SOAP 绑定 - 仅样式“文档”和“文字”的 SOAP 绑定支持编码。不支持“rpc”样式或 SOAP 编码。 WSDL:Import - 不支持此属性。客户应将导入内容合并到一个文档中。
包含多个部分的消息 - 这些类型的消息不是支持的。 WCF wsHttpBinding - 使用 Windows 创建的 SOAP 服务通信基础应该使用basicHttpBinding - wsHttpBinding 不支持。
MTOM - 使用 MTOM 的服务可能会工作。不提供官方支持此时。递归 - 递归定义的类型（对于例如，引用自己的数组）不受 APIM 支持。
多个命名空间 - 一个架构中可以使用多个命名空间，但只有目标命名空间可用于定义消息部分。目标以外的命名空间，用于定义其他不保留输入或输出元素。虽然这样的 WSDL 可以导入文档，导出时所有消息部分都将具有 WSDL 的目标命名空间。

【讨论】：