Freigeben über


Aktualisieren von externalConnection

Namespace: microsoft.graph.externalConnectors

Aktualisieren sie die Eigenschaften eines externalConnection-Objekts .

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

PATCH /external/connections/{connectionsId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an. Die folgenden Eigenschaften können aktualisiert werden.

Eigenschaft Typ Beschreibung
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.
description Zeichenfolge Beschreibung der verbindung, die im Microsoft 365 Admin Center angezeigt wird.
name Zeichenfolge Der Anzeigename der Verbindung, die im Microsoft 365 Admin Center angezeigt werden soll. Maximale Länge von 128 Zeichen.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Anforderung

PATCH https://graph.microsoft.com/v1.0/external/connections/contosohr
Content-type: application/json

{
  "name": "Contoso HR Service Tickets",
  "description": "Connection to index HR service tickets"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content