Erstellen von externalConnection
Namespace: microsoft.graph.externalConnectors
Erstellen Sie ein neues externalConnection-Objekt.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | ExternalConnection.ReadWrite.OwnedBy | ExternalConnection.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | ExternalConnection.ReadWrite.OwnedBy | ExternalConnection.ReadWrite.All |
HTTP-Anforderung
POST /external/connections
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des externalConnection-Objekts an.
Sie können die folgenden Eigenschaften angeben, wenn Sie eine externalConnection erstellen.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Die Verbindungs-ID. Erforderlich. |
name | String | Der Verbindungsname. Erforderlich. |
description | String | Die Verbindungsbeschreibung. Erforderlich. |
Konfiguration | microsoft.graph.externalConnectors.configuration | Die Verbindungskonfigurationen. Optional. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und ein externalConnection-Objekt im Antworttext zurückgegeben.
Hinweis: Wenn Sie eine externe Verbindung mit einem fehlerhaften adaptiven Karte für das Ergebnislayout erstellen, schlägt der erste Aufruf mit einem fehl
503 Service Unavailable
. Wenn Sie den Aufruf erneut versuchen, schlägt der zweite Aufruf mit einer409 Conflict
Antwort fehl, die besagt, dass bereits eine Verbindung mit demselben Namen vorhanden ist. Dies liegt daran, dass die Verbindung erstellt wurde, obwohl der erste Aufruf mit503 Service Unavailable
fehlgeschlagen ist. Weitere Informationen finden Sie unter Bekannte Probleme.
Beispiele
Anforderung
POST https://graph.microsoft.com/v1.0/external/connections
Content-Type: application/json
{
"id": "contosohr",
"name": "Contoso HR",
"description": "Connection to index Contoso HR system"
}
Antwort
Das folgende Beispiel zeigt die Antwort. Beachten Sie, dass die Id-, Name- und Beschreibungseigenschaften in der Antwortnutzlast vom System generiert werden und sich von denen unterscheiden, die sich in der erstellten Verbindung befinden.
HTTP/1.1 200 Created
Content-Type: application/json
{
"id": "0a4f4e74-4e74-0a4f-744e-4f0a744e4f0a",
"name": "String",
"description": "String",
"state": "ready",
"configuration": {
"authorizedAppIds": [
"d310d35d-72ec-47dd-92f2-fb9c40936555"
]
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für