schemaExtension aktualisierenUpdate schemaExtension

Namespace: Microsoft. GraphNamespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften in der Definition des angegebenen Schema Extension.Update properties in the definition of the specified schemaExtension.

Das Update gilt für alle Ressourcen, die in der TargetTypes -Eigenschaft der Erweiterung enthalten sind.The update applies to all the resources that are included in the targetTypes property of the extension. Diese Ressourcen gehören zu den unterstützenden Ressourcentypen.These resources are among the supporting resource types.

Nur die APP, die eine Schemaerweiterung (Besitzer-APP) erstellt hat, kann Additive Aktualisierungen an der Erweiterung vornehmen, wenn sich die Erweiterung im Status " indevelopment " oder " available " befindet.Only the app that created a schema extension (owner app) can make additive updates to the extension when the extension is in the InDevelopment or Available status. Das bedeutet, dass die APP keine benutzerdefinierten Eigenschaften oder Ziel Ressourcentypen aus der Definition entfernen kann.That means the app cannot remove custom properties or target resource types from the definition. Die APP kann jedoch die Beschreibung der Erweiterung ändern.The app can, however, change the description of the extension.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Directory.AccessAsUser.AllDirectory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

PATCH /schemaExtensions/{id}

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

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.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription ZeichenfolgeString Beschreibung für die Schemaerweiterung.Description for the schema extension.
propertiesproperties extensionSchemaProperty-SammlungextensionSchemaProperty collection Die Sammlung von Eigenschaftennamen und Typen, die die Schemaerweiterungsdefinition bilden.The collection of property names and types that make up the schema extension definition. Nur Additive Änderungen sind zulässig.Only additive changes are permitted.
statusstatus StringString Der Lebenszyklusstatus der Schemaerweiterung.The lifecycle state of the schema extension. Der anfängliche Zustand bei der Erstellung ist indevelopment.The initial state upon creation is InDevelopment. Mögliche Statusübergänge sind von der indevelopment bis zur verfüg barkeit und veraltet.Possible states transitions are from InDevelopment to Available and Available to Deprecated.
targetTypestargetTypes String-SammlungString collection Satz von Microsoft Graph-Typen (die Erweiterungen unterstützen können), auf die die Schemaerweiterung angewendet werden kann.Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Nur Additive Änderungen sind zulässig.Only additive changes are permitted.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.If successful, this method returns a 204 No Content response code.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/schemaExtensions/{id}
Content-type: application/json
Content-length: 201

{
  "properties": [
    {
      "name":"new-name-value",
      "type":"new-type-value"
    },
    {
      "name":"additional-name-value",
      "type":"additional-type-value"
    }
  ],
}
AntwortResponse
HTTP/1.1 204 No Content

Siehe auchSee also