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

Question

我无法公开从我的托管 API 下载开放 API v3 规范的链接。我看过这个博客说：

在 Azure 门户和开发人员门户中以及通过 REST API（仅限 YAML）导出 JSON 和 YAML 格式的 OpenAPI 规范 v3 文件。

但是，单击此链接，您可以看到显示 404。

我通过以下博客页面所能看到的是

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

openAPI-link

。

我不知道进行此调用的上下文（针对我们的 API 端点？？）。如有任何帮助，我们将不胜感激。

我已经尝试过

https://my.api.endpoint.com?format=openapi-link

但没有运气）

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

有什么建议吗？

Answer 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

更多详情请参阅这里