Verwenden der Microsoft Graph-Connectors-API
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.
Sie können Microsoft Graph-Connectors verwenden, um Daten aus externen Diensten in Microsoft Graph zu übertragen. Mit der Microsoft Graph-Connectors-API können Sie externe Daten indizieren, um intelligente Umgebungen in Microsoft 365 wie Copilot und Microsoft Search zu unterstützen.
Anforderungen zum Indizieren von Daten werden im Auftrag einer Anwendung ohne das Vorhandensein eines angemeldeten Benutzers über ein Zugriffstoken mit Anwendungsberechtigung ausgeführt.
Erstellen eines benutzerdefinierten Microsoft Graph-Connectors
Das Erstellen eines benutzerdefinierten Microsoft Graph-Connectors umfasst vier Schritte:
- Erstellen Sie eine Entra-ID (früher als Azure Active Directory bezeichnet) App-Registrierung. Zusammen mit der Anforderung an Microsoft Graph übermitteln Sie den Namen der App-Registrierung und api-Berechtigungen, die Ihre App benötigt. Microsoft Graph antwortet mit Informationen zur neu erstellten App-Registrierung.
- Erstellen Sie eine externe Verbindung. Jede Verbindung erfordert eine eindeutige ID, einen Namen und eine Beschreibung.
- Erstellen Sie das Schema für die externe Verbindung. Das Schema definiert die Form von externen Inhalten, die Sie über diese Microsoft Graph-Verbindung erfassen. Das Erstellen des Schemas ist ein Zeitintensiver Vorgang. Nachdem Sie das Schema zum Erstellen der Verbindung übermittelt haben, antwortet Microsoft Graph mit einer URL, mit der Sie den Status des Vorgangs überprüfen können. Das Schema wird bereitgestellt, solange der Vorgangsstatus lautet
inprogress. Nach Abschluss der Bereitstellung gibt der Vorgang einen Status zurückcompleted. - Erfassen externer Inhalte. Extrahieren Sie es für jedes externe Element aus dem Quellinhaltsrepository, transformieren Sie es so, dass es dem Schema für Ihre externe Verbindung entspricht, und übermitteln Sie es als externes Element an Microsoft Graph. Fügen Sie zusammen mit dem Element Informationen darüber ein, wer darauf zugreifen darf, auch als Zugriffssteuerungsliste (Access Control List, ACL) bezeichnet.
Im Folgenden sehen Sie ein Sequenzdiagramm, das die vier Schritte zum Erstellen eines Microsoft Graph-Connectors veranschaulicht.
Allgemeine Anwendungsfälle
In der folgenden Tabelle sind häufige Anwendungsfälle für die Microsoft Graph-Connectors-API aufgeführt.
| Anwendungsfälle | REST-Ressourcen | Siehe auch |
|---|---|---|
| Konfigurationsaktionen | ||
| Erstellen, Aktualisieren oder Löschen einer Verbindung | externalConnection | externalConnection Methoden |
| Registrieren eines Schemas für die externen Daten | schema | schema Methoden |
| Indizierungsaktionen | ||
| Hinzufügen, Aktualisieren oder Löschen eines benutzerdefinierten Elements im Index | externalItem | externalItem Methoden |
Bekannte Einschränkungen
Im folgenden werden die aktuell bekannten Beschränkungen aufgeführt:
- Organisationen sind auf maximal 10 Verbindungen beschränkt. (Wenn Sie weitere Verbindungen benötigen, füllen Sie das Anforderungsformular aus.)
- Sie können bis zu 25 externalItem-Ressourcenelemente pro Sekunde erstellen.
- Eine Anwendung ist auf 25 gleichzeitige Vorgänge für eine Verbindung beschränkt.
- Verbindungen weisen eine Kapazitätsbeschränkung von 5.000.000 Elementen oder ~ 350 GB Daten auf.
- Die maximale Größe einer externalItem-Entität beträgt 4 MB.
Nächste Schritte
- Weitere Informationen finden Sie in der Übersicht über Microsoft Graph-Connectors.
- Führen Sie einen Drilldown zu den Methoden, Eigenschaften und Beziehungen der Ressourcen externalConnection, schema, externalItem aus.
- Sehen Sie sich die Microsoft Graph-Postman-Sammlung an.
- Sehen Sie sich den Beispielsuchconnector an.