Ressourcentyp externalConnection

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 in Microsoft Graph.

Methoden

Methode Rückgabetyp Beschreibung
Erstellen von externalConnection externalConnection Erstellen Sie eine neue externalConnection , indem Sie sie in die Connections-Auflistung buchen.
Auflisten von externalConnections externalConnection-Auflistung Rufen Sie eine externalConnection-Objektsammlung ab.
Abrufen von ExternalConnection externalConnection Lesen von Eigenschaften und Beziehungen eines externalConnection-Objekts .
Aktualisieren von externalConnection externalConnection Aktualisieren Sie ein externalConnection-Objekt .
Löschen von externalConnection Keine Löschen Sie ein externalConnection-Objekt .
Schema erstellen Ohne oderSchema Verbindungsschema registrieren.
Vorgang abrufen connectionOperation Rufen Sie den Status einer asynchronen Anforderung zum Erstellen des Verbindungsschemas ab.
Erstellen von externalItem externalItem Erstellen Sie ein neues externalItem, indem Sie in die Elementsammlung buchen.
connectionQuota abrufen connectionQuota Rufen Sie die Eigenschaften und Beziehungen eines connectionQuota ab.

Eigenschaften

Eigenschaft Typ Beschreibung
activitySettings microsoft.graph.externalConnectors.activitySettings Sammelt konfigurierbare Einstellungen im Zusammenhang mit Aktivitäten, die Connectorinhalte betreffen.
Konfiguration microsoft.graph.externalConnectors.configuration Gibt zusätzliche Anwendungs-IDs an, die die Verbindung verwalten und Inhalte in der Verbindung indizieren dürfen. 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 sie die Art des aufgenommenen Inhalts signalisiert. Das korrekte Festlegen dieses Werts sorgt beispielsweise für eine bessere Abfrageinterpretation und verbessert die Copilot-Erfahrung. Die möglichen Werte sind: uncategorized, knowledgeBase, wikis, fileRepository, qnadashboard. taskManagementlearningManagementcrmpeoplemediaemailmessagingmeetingTranscripts Optional. Der Standardwert ist uncategorized.
description Zeichenfolge Im Microsoft 365 Admin Center wird die Beschreibung der Verbindung angezeigt. Optional.
enabledContentExperiences microsoft.graph.externalConnectors.contentExperienceType collection Die Liste der Inhaltserfahrungen, an denen die Verbindung teilnehmen wird. 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. Darf nicht mit Microsoft einem der folgenden Werte beginnen oder einer der folgenden Werte sein: None, Directory, Exchange, OneDriveBusinessTopicEnginePowerBIMSFT_All_ConnectorsAssistantTaskFabricConnectorsTeamsMailboxYammerExchangeArchiveLinkedInSharePoint. Erforderlich.
ingestedItemsCount Int64 Die Anzahl der in einer Verbindung aufgenommenen Elemente. Dieser Wert wird alle 15 Minuten aktualisiert. Wenn der Verbindungsstatus ist draft, ist ingestedItemsCountnull.
name Zeichenfolge Der Anzeigename der Verbindung, der im Microsoft 365 Admin Center angezeigt werden soll. Maximale Länge von 128 Zeichen. Erforderlich.
searchSettings microsoft.graph.externalConnectors.searchSettings Die Einstellungen, mit denen die Sucherfahrung für Inhalte in dieser Verbindung konfiguriert wird, z. B. die Anzeigevorlagen für Suchergebnisse.
state microsoft.graph.externalConnectors.connectionState Gibt den aktuellen Status der Verbindung an. Mögliche Werte sind draft, ready, obsolete, und limitExceeded. Erforderlich.

Beziehungen

Beziehung Typ Beschreibung
groups microsoft.graph.externalConnectors.externalGroup collection Schreibgeschützt. Nullwerte zulassend.
items microsoft.graph.externalConnectors.externalItem collection Schreibgeschützt. Lässt Nullwerte zu.
operations microsoft.graph.externalConnectors.connectionOperation collection 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"
}
  • Zuletzt aktualisiert um