如何通过 REST 链接公开 azure 托管 api openapi v3 yaml 文件答案

【问题标题】：How to expose azure managed api openapi v3 yaml file via REST link如何通过 REST 链接公开 azure 托管 api openapi v3 yaml 文件
【发布时间】：2021-07-01 21:13:21
【问题描述】：

我无法公开从我的托管 API 下载开放 API v3 规范的链接。我看到this blog 说：

在 azure 门户和开发者门户中以 JSON 和 YAML 格式导出 OpenAPI Specification v3 文件，以及通过the REST API（仅限 YAML）。

但是，如您所见，单击此链接会显示 404。

我可以通过following blog page 看到的只是

您还可以通过 Azure 门户的可视化界面或 REST API 调用导出规范，格式查询参数设置为openAPI-link。

我不知道此调用的上下文（针对我们的 API 端点？？）。感谢您提供任何帮助。

我试过 https://my.api.endpoint.com?format=openapi-link 没有运气）

 {
   "statusCode": 404,
   "message": "Resource not found" 
 }

有什么建议吗？

【问题讨论】：

标签： azure-api-management

【解决方案1】：

如果您想从 Azure API 管理中导出 api，我们可以使用以下 API 来执行此操作。它将 OpenAPI 3.0 规范中的 Api 定义作为 YAML 文档导出到存储 Blob。然后我们就可以从blob下载文件了

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}?format=openapi-link 
&export=true&api-version=2019-12-01

更多详情请参考here

【讨论】：