schemaExtension aktualisieren

Namespace: microsoft.graph

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.

Aktualisieren Sie Eigenschaften in der Definition der angegebenen schemaExtension. Additive Aktualisierungen an der Erweiterung können nur vorgenommen werden, wenn sich die Erweiterung im Status ODER Available befindetInDevelopment. Das bedeutet, dass benutzerdefinierte Eigenschaften oder Zielressourcentypen nicht aus der Definition entfernt werden können, aber neue benutzerdefinierte Eigenschaften hinzugefügt und die Beschreibung der Erweiterung geändert werden können.

Das Update gilt für alle Ressourcen, die in der targetTypes-Eigenschaft der Erweiterung enthalten sind. Diese Ressourcen gehören zu den unterstützenden Ressourcentypen.

Bei delegierten Flows kann der angemeldete Benutzer eine Schemaerweiterung aktualisieren, solange die owner-Eigenschaft der Erweiterung auf die appId einer Anwendung festgelegt ist, die dem angemeldeten Benutzer gehört. Diese Anwendung kann diejenige sein, die die Erweiterung ursprünglich erstellt hat, oder eine andere Anwendung, die dem angemeldeten Benutzer gehört.

Dieses Kriterium für die owner-Eigenschaft ermöglicht es einem angemeldeten Benutzer, Updates über andere Anwendungen vorzunehmen, die er nicht besitzt, z. B. Microsoft Graph Explorer. Wenn Sie Graph Explorer verwenden, um eine schemaExtension-Ressource zu aktualisieren, schließen Sie die owner-Eigenschaft in den PATCH-Anforderungstext ein.

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) Application.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Application.ReadWrite.All und Directory.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

PATCH /schemaExtensions/{id}

Optionale Anforderungsheader

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

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 oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.

Eigenschaft Typ Beschreibung
description String Beschreibung für die Schemaerweiterung.
properties extensionSchemaProperty-Sammlung Die Sammlung von Eigenschaftennamen und Typen, die die Schemaerweiterungsdefinition bilden. Es sind nur additive Änderungen zulässig.
status String Der Lebenszyklusstatus der Schemaerweiterung. Der Anfangsstatus bei der Erstellung ist InDevelopment. Mögliche Statusübergänge sind von InDevelopment zu Available und Available zu Deprecated.
targetTypes String-Sammlung Satz von Microsoft Graph-Typen (die Erweiterungen unterstützen können), auf die die Schemaerweiterung angewendet werden kann. Es sind nur additive Änderungen zulässig.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Der Versuch, diese Anforderung von einer Anwendung auszuführen, die Sie nicht besitzen (und ohne dieowner-Eigenschaft auf die appId einer Anwendung zu setzen, die Sie besitzen), gibt einen 403 Forbidden Antwortcode zurück.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage. Sie müssen die owner-Eigenschaft einschließen, wenn Sie die Anforderung aus einer Anwendung ausführen, die Ihnen nicht gehört. Legen Sie in diesem Fall die owner-Eigenschaft auf die appId einer Anwendung fest, deren Besitzer Sie sind.

PATCH https://graph.microsoft.com/beta/schemaExtensions/exto6x7sfft_courses
Content-type: application/json

{
    "owner": "ef4cb9a8-97c3-4ca7-854b-5cb5ced376fa",
    "properties": [
        {
            "name": "courseId",
            "type": "Integer"
        },
        {
            "name": "courseName",
            "type": "String"
        },
        {
            "name": "courseType",
            "type": "String"
        },
        {
            "name": "courseSupervisors",
            "type": "String"
        }
    ]
}

Antwort

HTTP/1.1 204 No Content