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 | Ruft den 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 | Zeichenfolge | Die Teams-App-ID. Optional. |
| 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 im 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 zeigt 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"
}