Freigeben über

externalConnection-Ressourcentyp

Namespace: microsoft.graph.externalConnectors

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ein logischer Container zum Hinzufügen von Inhalten aus einer externen Quelle zu Microsoft Graph.

Methoden

Methode Rückgabetyp Beschreibung
Erstellen von externalConnection externalConnection Erstellen Sie eine neue externalConnection, indem Sie in der Connections-Sammlung veröffentlichen.
Auflisten von externalConnections externalConnection-Auflistung Ruft eine externalConnection-Objektauflistung ab.
Abrufen von ExternalConnection externalConnection Lesen von Eigenschaften und Beziehungen eines externalConnection-Objekts .
Aktualisieren von externalConnection externalConnection Aktualisieren eines externalConnection-Objekts .
Löschen von externalConnection Keine Löschen Sie ein externalConnection-Objekt .
Schema erstellen None oderSchema Registrieren des Verbindungsschemas.
Vorgang abrufen connectionOperation Rufen Sie die status einer asynchronen Anforderung zum Erstellen des Verbindungsschemas ab.
Erstellen von externalItem externalItem Erstellen Sie ein neues externalItem,indem Sie in der Items-Auflistung veröffentlichen.
connectionQuota abrufen connectionQuota Ruft die Eigenschaften und Beziehungen einer connectionQuota ab.

Eigenschaften

Eigenschaft Typ Beschreibung
activitySettings microsoft.graph.externalConnectors.activitySettings Erfasst konfigurierbare Einstellungen im Zusammenhang mit Aktivitäten, die Connectorinhalte betreffen.
Konfiguration microsoft.graph.externalConnectors.configuration Gibt zusätzliche Anwendungs-IDs an, die zum Verwalten der Verbindung und zum Indizieren von Inhalten in der Verbindung zulässig sind. Optional.
connectorId Zeichenfolge Die Teams-App-ID. Optional.
contentCategory microsoft.graph.externalConnectors.contentCategory Gibt die Domänenkategorie des Inhalts an, der der externen Verbindung zugeordnet ist. Diese Eigenschaft hilft Microsoft Graph bei der Optimierung von Relevanz, Rangfolge und semantischem Verständnis, indem die Art des erfassten Inhalts signalisiert wird. Durch das richtige Festlegen dieses Werts wird beispielsweise eine bessere Abfrageinterpretation sichergestellt und die Copilot-Erfahrung verbessert. Die möglichen Werte sind: uncategorized, knowledgeBase, wikis, fileRepository, qna, , dashboardcrm, people, media, email, messagingmeetingTranscripts, , taskManagement, . learningManagement Optional. Der Standardwert ist uncategorized.
description Zeichenfolge Beschreibung der verbindung, die im Microsoft 365 Admin Center angezeigt wird. Optional.
enabledContentExperiences microsoft.graph.externalConnectors.contentExperienceType-Sammlung Die Liste der Inhaltserfahrungen, an der die Verbindung teilnimmt. Mögliche Werte sind search.
id Zeichenfolge Vom Entwickler bereitgestellte eindeutige ID der Verbindung innerhalb des Microsoft Entra Mandanten. Muss zwischen 3 und 32 Zeichen lang sein. Darf nur alphanumerische Zeichen enthalten. Kann nicht mit Microsoft einem der folgenden Werte beginnen oder sein: None, Directory, , Exchange, LinkedInExchangeArchive, MailboxYammerConnectorsTeamsSharePointOneDriveBusiness, . MSFT_All_ConnectorsTaskFabricPowerBIAssistantTopicEngine Erforderlich.
ingestedItemsCount Int64 Die Anzahl der in einer Verbindung erfassten Elemente. Dieser Wert wird alle 15 Minuten aktualisiert. Wenn der Verbindungsstatus lautetdraft, ist nullingestedItemsCount .
name Zeichenfolge Der Anzeigename der Verbindung, die im Microsoft 365 Admin Center angezeigt werden soll. Maximale Länge von 128 Zeichen. Erforderlich.
searchSettings microsoft.graph.externalConnectors.searchSettings Die Einstellungen, die die Suchoberfläche für Inhalte in dieser Verbindung konfigurieren, z. B. die Anzeigevorlagen für Suchergebnisse.
state microsoft.graph.externalConnectors.connectionState Gibt den aktuellen Zustand der Verbindung an. Mögliche Werte sind draft, ready, obsoleteund limitExceeded. Erforderlich.

Beziehungen

Beziehung Typ Beschreibung
groups microsoft.graph.externalConnectors.externalGroup-Sammlung Schreibgeschützt. Nullwerte zulassend.
items microsoft.graph.externalConnectors.externalItem-Auflistung Schreibgeschützt. Lässt Nullwerte zu.
operations sammlung microsoft.graph.externalConnectors.connectionOperation Schreibgeschützt. Nullwerte zulassend.
quota microsoft.graph.externalConnectors.connectionQuota Schreibgeschützt. Nullwerte zulassend.
Schema microsoft.graph.externalConnectors.schema Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "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"
}
  • Last updated on