externalConnection 资源类型

命名空间：microsoft.graph.externalConnectors

重要

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

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

方法

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

属性

属性	类型	说明
activitySettings	microsoft.graph.externalConnectors.activitySettings	收集与涉及连接器内容的活动相关的可配置设置。
configuration	microsoft.graph.externalConnectors.configuration	指定允许管理连接和索引连接内容的其他应用程序 ID。 可选。
connectorId	String	Teams 应用 ID。 可选。
说明	String	Microsoft 365 管理中心中显示的连接说明。 可选。
enabledContentExperiences	microsoft.graph.externalConnectors.contentExperienceType 集合	连接将参与的内容体验列表。 可能的值为 search。
id	String	开发人员提供的Microsoft Entra租户中连接的唯一 ID。 长度必须介于 3 到 32 个字符之间。 只能包含字母数字字符。 不能以 Microsoft 下列值之一开头或为以下值之一：None、Directory、Exchange、、LinkedInExchangeArchive、TeamsSharePointYammerConnectorsMailboxOneDriveBusinessTaskFabric、PowerBI、Assistant、 。 MSFT_All_ConnectorsTopicEngine 必填。
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 集合	此为只读属性。 可为 NULL。
operations	microsoft.graph.externalConnectors.connectionOperation 集合	此为只读属性。 可为 NULL。
配额	microsoft.graph.externalConnectors.connectionQuota	此为只读属性。 可为 NULL。
模式	microsoft.graph.externalConnectors.schema	此为只读属性。 可为 Null。

JSON 表示形式

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

{
  "activitySettings": {"@odata.type": "microsoft.graph.externalConnectors.activitySettings"},
  "configuration": {"@odata.type": "microsoft.graph.externalConnectors.configuration"},
  "connectorId": "String",
  "description": "String",
  "enabledContentExperiences": "[String]",
  "id": "String (identifier)",
  "ingestedItemsCount": "Int64",
  "name": "String",
  "searchSettings": {"@odata.type": "microsoft.graph.externalConnectors.searchSettings"},
  "state": "String"
}