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

添加合成 GraphQL API 并设置字段解析程序

适用于：所有 API 管理层级

在 API 管理中，可以在以下两个模型之一中添加 GraphQL API：直通到现有 GraphQL 终结点，或导入 GraphQL 架构并使用自定义字段解析程序创建合成 GraphQL API。有关详细信息，请参阅 GraphQL 概述。

在本文中，你将：

若要将现有 GraphQL 终结点公开为 API，请参阅导入 GraphQL API。

先决条件

在对话框中，选择“完整”并填写必填的表单字段。

用于创建 GraphQL API 的字段的屏幕截图。

字段	说明
显示名称	GraphQL API 的显示名称。
名称	GraphQL API 的原始名称。键入显示名称时自动填充。
GraphQL 类型	选择要从 GraphQL 架构文件导出的合成 GraphQL。
回退 GraphQL 终结点	可以选择输入包含 GraphQL API 终结点名称的 URL。如果未为字段设置自定义解析程序，API 管理会将 GraphQL 查询传递给此终结点。
说明	添加 API 的说明。
URL 方案	根据 GraphQL 终结点进行选择。如果 GraphQL API 包含订阅类型，请选择其中一个包含 WebSocket 方案（WS 或 WSS）的选项。默认选择：HTTP(S)。
API URL 后缀	添加 URL 后缀以在该 API 管理实例中标识此特定 API。在该 API 管理实例中，后缀必须唯一。
基 URL	显示 API 基 URL 的不可编辑字段
标记	将 GraphQL API 与新标记或现有标记关联。
产品	将 GraphQL API 与产品关联来发布它。
对此 API 进行版本控制？	选择向你的 GraphQL API 应用某个版本控制方案。

配置解析程序，以将架构中的字段映射到现有 HTTP 终结点。此处提供了大致步骤。如需详细信息，请参阅配置 GraphQL 解析程序。

假设你导入了以下基本 GraphQL 架构并想要为 users 查询设置解析程序。

type Query {
    users: [User]
}

type User {
    id: String!
    name: String!
}

在边侧导航菜单中的“API”部分下，选择“API”> 你的 GraphQL API。
在“架构”选项卡上，查看（要在其中配置解析程序的）对象类型中字段的架构。
1. 选择一个字段，然后在左边距中悬停指针。
2. 选择“+ 添加解析程序”
在“创建解析程序”页上：
1. 根据需要更新“名称”属性，可选择输入“说明”，并确认或更新“类型”和“字段”选择。
2. 在“数据源”中，选择“HTTP API”。
在解析程序策略编辑器中，使用适用于方案的子元素更新 <http-data-source> 元素。例如，以下解析程序通过对现有 HTTP 数据源发出 GET 调用来检索“用户”字段。
```
    <http-data-source>
        <http-request>
            <set-method>GET</set-method>
            <set-url>https://myapi.contoso.com/users</set-url>
        </http-request>
    </http-data-source>
```
选择“创建”。
要解析架构中其他字段的数据，请重复上述步骤以创建解析程序。