Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph.externalConnectors
Erstellen Sie ein neues externalConnection-Objekt.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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 |
| Application | ExternalConnection.ReadWrite.OwnedBy | ExternalConnection.ReadWrite.All |
HTTP-Anforderung
POST /external/connections
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über 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 | Zeichenfolge | Die Verbindungs-ID. Erforderlich. |
| name | Zeichenfolge | Der Verbindungsname. Erforderlich. |
| description | Zeichenfolge | 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.
Anmerkung: 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 ConflictAntwort 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 Unavailablefehlgeschlagen 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"
]
}
}