通过


你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

编辑 API

适用于:所有 API 管理层级

本文介绍如何使用Azure API 管理编辑 API。

  • 可以在 Azure 门户中添加、重命名或删除操作。
  • 可以编辑 API 的 swagger。

Prerequisites

转到你的 API 管理实例

  1. 在 Azure portal 中,搜索并选择 API 管理服务

    在搜索结果中显示 API 管理服务的屏幕截图。

  2. 在“API 管理服务”页上,选择你的 API 管理实例:

    显示“API 管理服务”页面上的 API 管理实例的屏幕截图。

编辑操作

  1. 在“API”下选择“API”。
  2. 选择已导入的 API。
  3. 选择“设计”选项卡。
  4. 选择要编辑的操作。
  5. 若要重命名操作,请在“前端”窗格中选择铅笔按钮。

显示 API 管理中编辑 API 的过程的屏幕截图。

更新 swagger

可以通过在 Azure 门户完成以下步骤来更新 API 的 Swagger:

  1. 在API页面上,选择所有操作。

  2. 在 前端 窗格中选择铅笔按钮。

    显示前端窗格中铅笔按钮的屏幕截图。

    将显示 API 的 swagger。

    显示 API 的 Swagger 的屏幕截图。

  3. 更新 swagger。

  4. 选择“保存”。

警告

如果要编辑 API 的非当前修订,则无法更改以下属性:

  • 名称
  • 类型
  • 说明
  • 需要订阅
  • API 版本
  • API 版本说明
  • 路径
  • 协议

如果你的编辑更改了非当前修订中的任何一个属性,你将看到错误消息 。

  • API 导入限制
  • 导入 OpenAPI 规范
  • 导入 SOAP API
  • 导入 SOAP API 并将其转换为 REST
  • 导入应用服务 API
  • 导入容器应用 API
  • 导入 WebSocket API
  • 导入 GraphQL API
  • 导入 GraphQL 架构并设置字段解析程序
  • 导入函数应用 API
  • 导入逻辑应用 API
  • 导入 Service Fabric 服务
  • 导入 Microsoft Foundry API
  • 导入 Azure OpenAI API
  • 导入 LLM API
  • 导入 OData API
  • 将 REST API 导出为 MCP 服务器
  • 公开现有的 MCP 服务器
  • 导入 A2A 代理 API
  • 导入 SAP OData 元数据
  • 导入 gRPC API
  • 编辑 API