externalConnection 资源类型

命名空间：microsoft.graph.externalConnectors

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

一个逻辑容器，用于将外部源中的内容添加到 Microsoft Graph。

方法

方法	返回类型	说明
创建 externalConnection	externalConnection	通过发布到连接集合来创建新的 externalConnection 。
列出 externalConnections	externalConnection 集合	获取 externalConnection 对象集合。
获取 externalConnection	externalConnection	读取 externalConnection 对象的属性和关系。
更新 externalConnection	externalConnection	更新 externalConnection 对象。
删除 externalConnection	无	删除 externalConnection 对象。
创建架构	无 或架构	注册连接架构。
获取操作	connectionOperation	获取用于创建连接架构的异步请求的状态。
创建 externalItem	externalItem	通过发布到项目集合来创建新的 externalItem。
获取 connectionQuota	connectionQuota	检索 connectionQuota 的属性和关系。

属性

属性	类型	说明
configuration	microsoft.graph.externalConnectors.configuration	指定允许管理连接和为连接中的内容编制索引的其他应用程序 ID。 可选。
connectorId	String	Teams应用 ID。 可选。
说明	String	Microsoft 365 管理中心中显示的连接的说明。 可选。
id	String	开发人员提供的连接在Azure Active Directory租户中的唯一 ID。 长度必须介于 3 到 32 个字符之间。 必须仅包含字母数字字符。 不能以Microsoft以下值之一开头或为以下值之一：None、、Exchange``Directory、ExchangeArchive、LinkedIn、OneDriveBusiness``Mailbox、SharePoint、Teams``Yammer、、Connectors、TaskFabric、PowerBI、、Assistant、、、 MSFT_All_Connectors``TopicEngine 必填。
ingestedItemsCount	Int64	引入到连接中的项数。 此值每 15 分钟刷新一次。 如果连接状态为 draft，则 ingestedItemsCount 将为 null.
name	String	要在Microsoft 365 管理中心中显示的连接的显示名称。 最大长度为 128 个字符。 必填。
searchSettings	microsoft.graph.externalConnectors.searchSettings	配置此连接中内容的搜索体验的设置，例如搜索结果的显示模板。
state	microsoft.graph.externalConnectors.connectionState	指示连接的当前状态。 可能的值是draft， ready和 obsolete``limitExceeded. 必填。

关系

关系	类型	说明
groups	microsoft.graph.externalConnectors.externalGroup 集合	只读。可为 Null。
items	microsoft.graph.externalConnectors.externalItem 集合	只读。可为空。
operations	microsoft.graph.externalConnectors.connectionOperation 集合	只读。可为 Null。
配额	microsoft.graph.externalConnectors.connectionQuota	只读。可为 Null。
模式	microsoft.graph.externalConnectors.schema	只读。可为空。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "description": "String",
  "id": "String (identifier)",
  "ingestedItemsCount": "Int64",
  "name": "String",
  "state": "String"
}