大网数据广告活动
Microsoft Graph 接口

创建、更新和删除 Microsoft Graph 中的连接

· 52CE 我爱测

了解如何使用 Microsoft Graph 创建和管理员连接 包括连接状态表以及每个状态中可用的操作。

创建、更新和删除 Microsoft Graph 中的连接

外部服务与 Microsoft 搜索服务的连接由 Microsoft Graph 中的 externalConnection 资源表示。

Microsoft Graph 连接器平台提供了将外部数据添加到Microsoft Graph 的直观方法。 连接是外部数据的逻辑容器,管理员可将其作为一个单元进行管理。

创建连接后,可以添加来自任何外部数据源(例如本地内容源或外部 SaaS 服务)的内容。 只能查看并管理 已创建 或已显式授权管理的连接。 搜索管理员可以从现代管理中心查看和管理租户中的所有连接。

示例自定义帮助台系统票证连接器结构。

示例自定义帮助台系统票证连接器结构。

连接的管理员视图,包括自定义票证连接器。

连接的管理员视图,包括自定义票证连接器。

可以根据需要对连接进行建模,但为连接器的每个实例创建连接是最常见的模型。 例如,每次 设置 Microsoft Windows 文件共享连接器 时,都会新建连接。 你还可以创建一个连接来添加数据源中的所有项目。 例如,可以创建单个连接,从而从帮助台系统跨多个团队添加所有票证和事件。

状态与操作

你的连接可以以下列一种状态存在。

状态 说明
Draft 已预配空连接。尚未配置数据源、架构或任何设置。
Ready 该连接配有已注册的架构并已准备好接收。
Obsolete 如果已弃用依赖功能(如 API),则会出现这种情况。 删除连接是唯一有效的操作。
LimitExceeded 如果达到所有连接内单个连接或租户级别配额的最大限制,则在退出状态之前无法添加更多项。

下表指定每种状态中的可用操作。

Operation Draft Ready Obsolete LimitExceeded
Create Connection :x: :heavy_check_mark: :x: :heavy_check_mark:
Read connection :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
更新连接 :heavy_check_mark: :heavy_check_mark: :x: :heavy_check_mark:
删除连接 :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
创建架构 :heavy_check_mark: :x: :x: :x:
读取架构 :x: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
更新架构 :x: :x: :x: :x:
删除架构 :x: :x: :x: :x:
创建项目 :x: :heavy_check_mark: :x: :x:
读取项目 :x: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
更新项目 :x: :heavy_check_mark: :x: :heavy_check_mark:
删除项目 :x: :heavy_check_mark: :x: :heavy_check_mark:

通过连接,应用程序可以为将编制索引的项 定义架构,并为服务提供终结点,从而从索引添加、更新或删除项。

应用程序将项添加到搜索索引的第一步是创建连接。

创建连接

应用程序必须先创建并配置连接,然后才可将项添加到搜索索引:

  1. 使用唯一 ID、显示名称和说明创建连接。
  2. 注册架构,以定义索引中将包含的字段。

Note: 有关更新现有连接的架构的信息,请参阅架构更新功能。

更新连接

要更改现有连接的显示名称或说明,可以 更新连接。

删除连接

要删除所有已通过连接编制索引的项,可以 删除连接。

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mecampos)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。