Verwenden von Postman zum Testen der Microsoft Graph-Connectors-API

Die Microsoft Graph Postman-Sammlung enthält Beispielanforderungen für die Connectors-API. Entwickler können Postman verwenden, um die API auszuprobieren, ohne Code zu schreiben.

Voraussetzungen

• Forken Sie die Microsoft Graph Postman-Sammlung.
• Fügen Sie der app-Registrierung, die ExternalConnection.ReadWrite.OwnedBy für Postman erstellt wurde, die Berechtigungen und ExternalItem.ReadWrite.OwnedBy hinzu.
• Verwenden Sie Postman, um sich mit der reinen App-Authentifizierung zu authentifizieren.

Connectors-API-Anforderungen befinden sich im Ordner Application ->Graph Connectors .

Erstellen einer neuen Verbindung

Suchen Sie die Anforderung Verbindungsbeispiel erstellen im Ordner Verbindungseinrichtung . Verwenden Sie diese Beispielanforderung, um eine neue Verbindung zu erstellen. Der Ordner Verbindungseinrichtung enthält auch andere Beispielanforderungen zum Verwalten von Verbindungen.

Registrieren des Verbindungsschemas

Suchen Sie die Beispielanforderung Schema registrieren im Ordner Verbindungseinrichtung ->Schema verwalten . Verwenden Sie diese Beispielanforderung, um ein Schema für die von Ihnen erstellte Verbindung zu registrieren. Diese Anforderung gibt eine Antwort zurück, die wie folgt aussieht.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/external/connections/sampleConnectionId/operations/616bfeed-666f-4ce0-8cd9-058939010bfc

Das Registrieren eines Schemas ist ein asynchroner Vorgang. Die im Location Header zurückgegebene URL sollte für die status dieses Vorgangs abgefragt werden, bis die status istcompleted. Suchen Sie den Get-Vorgang status Beispielanforderung im Ordner Verbindungseinrichtung. Ersetzen Sie die Anforderungs-URL durch den Wert im Location Header, und senden Sie die Anforderung, um status zu überprüfen. Diese Anforderung gibt eine Antwort zurück, die wie folgt aussieht.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "616bfeed-666f-4ce0-8cd9-058939010bfc",
    "name": "Sample connection",
    "status": "inprogress",
    "error": null
}

Senden Sie die Anforderung erneut, bis die status -Eigenschaft auf completedfestgelegt ist. Warten Sie mindestens eine Minute zwischen dem erneuten Senden dieser Anforderung.

Der Ordner Schema verwalten enthält auch andere Beispielanforderungen zum Verwalten von Verbindungen.

Hinzufügen eines externen Gruppenmitglieds (optional)

Wenn Ihr externer Dienst nicht Microsoft Entra ID Zugriffssteuerungslisten (Access Control Lists, ACLs) verwendet, synchronisieren Sie diese Berechtigungen. Externe Gruppen (zusammen mit Microsoft Entra ID Benutzern und Gruppen) werden verwendet, um Berechtigungen externalItems für festzulegen, die einer Microsoft Graph-Verbindung hinzugefügt werden. Weitere Informationen finden Sie unter externalGroup.

Beispielanforderungen zum Erstellen externer Gruppen und Hinzufügen von Mitgliedern befinden sich im Ordner "Identitätssynchronisierung" .

Erfassen von Elementen

Hinweis

Erfassen Sie erst Elemente in der Verbindung, wenn sich das Verbindungsschema im completed Zustand befindet.

Suchen Sie im Inhaltssynchronisierungsordner nach der Anforderung Put item sample request ( Element einfügen). Verwenden Sie diese Beispielanforderung, um ein Element zu erfassen. Der Inhaltssynchronisierungsordner enthält auch andere Beispielanforderungen für die Verwaltung von Elementen.

Fehlerbehandlung

Ausführliche Informationen zum Beheben von Fehlern finden Sie unter Microsoft Graph-Autorisierungsfehler.

Verwandte Inhalte

• Verwenden von Postman mit Microsoft Graph-API