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.
ExternalConnection abrufen	externalConnection	Lesen von Eigenschaften und Beziehungen eines externalConnection-Objekts .
Aktualisieren von externalConnection	externalConnection	Aktualisieren eines externalConnection-Objekts .
ExternalConnection löschen	Keine	Löschen Sie ein externalConnection-Objekt .
Schema erstellen	None oderSchema	Registrieren des Verbindungsschemas.
Get-Vorgang	connectionOperation	Rufen Sie die status einer asynchronen Anforderung zum Erstellen des Verbindungsschemas ab.
ExternalItem erstellen	externalItem	Erstellen Sie ein neues externalItem,indem Sie in der Items-Auflistung veröffentlichen.
Verbindung abrufenQuota	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	String	Die Teams-App-ID. Optional.
description	String	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	String	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	String	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

Es folgt eine JSON-Darstellung der Ressource.

{
  "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"
}