获取从Visual Studio作为zip发布的功能应用程序的API定义

Question

我已经在Visual Studio中实现了一个Azure Function应用程序，并使用推荐的“ Zip Deploy”部署了该程序包。这意味着Function App在azure门户上处于只读模式，当尝试创建API定义时，我收到消息：

API定义（Swagger）在只读模式下不适用于Function Apps。

在功能应用程序设置中，在功能应用程序编辑模式下，切换至“读/写”也是灰色的。

如何获取API定义？ 我想用它来将功能与PowerApps或Flow连接起来。

Answer 1

OpenAPI预览功能仅今天在1.x运行时可用。对于v1，您可以创建一个this之类的OpenAPI definitionFunction。对于v2，API定义功能当前不支持Beta运行时。这是有关OpenAPI 2.0 metadata support in Azure Functions (preview)的文档。

解决方法：

使用在Azure Functions上使用HTTP触发器的外部库Aliencube.AzureFunctions.Extensions.OpenApi，您可以在版本1.x和2.x 上使用此库。

有关如何呈现Open API文档的更多详细信息，请参阅此article。