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

导入 OData API

适用于:所有 API 管理层级

本文介绍如何在 API 管理中将符合 OData 标准的服务导入为 API。

在本文中,学习如何:

  • 使用 Azure 门户导入 OData 元数据说明
  • 在门户中管理 OData 架构
  • 保护 OData API

先决条件

  • API 管理实例。 如果你还没有 API 管理服务实例,请完成以下快速入门:创建 Azure API 管理实例

  • 公开为 OData v2 或 v4 的服务。

转到你的 API 管理实例

  1. 在 Azure 门户中,搜索并选择“API 管理服务”。

    选择“API 管理服务”

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

    选择你的 API 管理实例

导入 OData 元数据

  1. 在左侧菜单中,选择“API”>“+ 添加 API”。

  2. 在“根据定义创建”下,选择“OData”。

    从门户中的 OpenAPI 说明 API 的屏幕截图。

  3. 输入 API 设置。 稍后可以转到 API 的“设置”选项卡来更新设置。

    1. OData 规范中,输入 OData 元数据终结点的 URL,通常是服务根的 URL,并附加 /$metadata。 或者,选择要导入的本地 OData XML 文件。

    2. 输入其余设置以配置 API。 在导入和发布第一个 API 教程中对这些设置进行了说明。

  4. 选择“创建”。

    API 将添加到 API 列表中。 OData 元数据说明中公开的实体集和函数显示在 API 的“实体集和函数”选项卡上。

    门户中 OData 实体集和函数的屏幕截图。

更新 OData 架构

可以在门户中访问编辑器以查看 API 的 OData 架构。 如果 API 发生更改,还可以从文件或 OData 服务终结点更新 API 管理中的架构。

  1. 门户中导航到 API 管理实例。

  2. 在左侧菜单中,选择 OData API 的“API”>。

  3. 在“实体集和函数”选项卡上,选择实体集或函数旁边的上下文菜单 (...),然后选择“编辑”。

    门户中 OData 实体集的上下文菜单的屏幕截图。

  4. 查看架构。 如果要更新它,请选择“从文件更新”或“从终结点更新架构”。

    门户中 OData API 架构编辑器的屏幕截图。

测试 OData API

  1. 在左侧菜单中,选择 OData API 的“API”>。

  2. 在“实体集和函数”选项卡上,选择实体集或函数旁边的上下文菜单 (...),然后选择“测试”。

    门户中 OData 实体集上下文菜单上的“测试”选项的屏幕截图。

  3. 在测试控制台中,输入测试的模板参数、查询参数和标头,然后选择“测试”。 详细了解如何在门户中测试 API。

保护 OData API

通过应用现有的身份验证和授权策略以及 OData 验证策略来保护 OData API,防止通过 OData API 请求发动的攻击。

提示

在门户中,在“API 策略”选项卡上为 OData API 配置策略

追加其他 API

可以为不同服务公开的 API 撰写 API,包括:

  • OpenAPI 规范
  • SOAP API
  • GraphQL API
  • Azure 应用服务中托管的 Web 应用
  • Azure 函数应用
  • Azure 逻辑应用
  • Azure Service Fabric

按照以下步骤将其他 API 追加到现有 API。

注意

导入另一个 API 时,操作将追加到当前 API 后面。

  1. 在 Azure 门户中转到自己的 Azure API 管理实例。

    转到 Azure API 管理实例

  2. 在概述页面上或左侧的菜单上选择“API” 。

    选择“API”

  3. 单击要将另一个 API 追加到的 API 旁边的“...”

  4. 从下拉菜单中选择“导入”。

    选择“导入”

  5. 选择要从中导入 API 的服务。

    选择服务