schemaExtension-Ressourcentyp (Schemaerweiterungen)schemaExtension resource type (schema extensions)

Mithilfe von Schemaerweiterungen können Sie ein Schema definieren, um stark typisierte benutzerdefinierte Daten zu erweitern und einem Ressourcentyp hinzuzufügen. Die benutzerdefinierten Daten werden in der erweiterten Ressource als komplexer Typ angezeigt.Schema extensions allow you to define a schema to extend and add strongly-typed custom data to a resource type. The custom data appears as a complex type on the extended resource.

Schemaerweiterungen werden von den folgenden Ressourcentypen unterstützt:Schema extensions are supported by the following resource types:

Im Beispiel für Schemaerweiterungen erfahren Sie, wie Sie benutzerdefinierte Daten zu Gruppen hinzufügen.See the schema extension example to learn how to add custom data to groups.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
CreateCreate schemaExtensionschemaExtension Dient zum Erstellen einer Schemaerweiterungsdefinition.Create a schema extension definition.
ListList schemaExtensionschemaExtension Dient zum Auflisten der verfügbaren schemaExtension-Definitionen und ihrer Eigenschaften.List the available schemaExtension definitions and their properties.
GetGet schemaExtensionschemaExtension Dient zum Lesen der Eigenschaften einer bestimmten schemaExtension-Definition.Read the properties of a specific schemaExtension definition.
UpdateUpdate schemaExtensionschemaExtension Dient zum Aktualisieren einer schemaExtension-Definition.Update a schemaExtension definition.
DeleteDelete KeineNone Dient zum Löschen einer schemaExtension-Definition.Delete a schemaExtension definition.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription StringString Beschreibung für die Schemaerweiterung.Description for the schema extension.
idid StringString Der eindeutige Bezeichner für die Schemaerweiterungsdefinition.The unique identifier for the schema extension definition.
Sie können einen Wert mit einer von zwei Methoden zuweisen:You can assign a value in one of two ways:
  • Verketten Sie den Namen einer Ihrer überprüften Domänen mit einem Namen für die Schemaerweiterung, um eine eindeutige Zeichenfolge in diesem Format zu bilden: {domainName}_{schemaName}. Beispiel: contoso_mySchema. Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, {domainName}_{schemaName}. As an example, contoso_mySchema.
  • Geben Sie einen Schemanamen an, und verwenden Sie diesen Schemanamen in Microsoft Graph zum Vervollständigen der id-Zuweisung in diesem Format: ext{8-random-alphanumeric-chars}_{schema-name}. Zum Beispiel: extkvbmkofy_mySchema.Provide a schema name, and let Microsoft Graph use that schema name to complete the id assignment in this format: ext{8-random-alphanumeric-chars}_{schema-name}. An example would be extkvbmkofy_mySchema.
Diese Eigenschaft kann nach dem Erstellen nicht mehr geändert werden.This property cannot be changed after creation.
ownerowner ZeichenfolgeString Die appId der Anwendung, die der Besitzer der Schemaerweiterung ist.The appId of the application that is the owner of the schema extension. Diese Eigenschaft kann bei der Erstellung bereitgestellt werden, um den Besitzer anzugeben.This property can be supplied on creation, to set the owner. Wird Sie nicht bereitgestellt, wird die appId der aufrufenden Anwendung als Besitzer festgelegt.If not supplied, then the calling application's appId will be set as the owner. In beiden Fällen muss der angemeldete Benutzer angemeldet der Besitzer der Anwendung sein.In either case, the signed-in user must be the owner of the application. Wurde diese Eigenschaft einmal festgelegt, ist sie schreibgeschützt und kann nicht geändert werden.Once set, this property is read-only and cannot be changed.
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.
statusstatus StringString Der Lebenszyklusstatus der Schemaerweiterung.The lifecycle state of the schema extension. Mögliche Statuswerte sind: InDevelopment, Available und Deprecated.Possible states are InDevelopment, Available, and Deprecated. Wird bei der Erstellung automatisch auf InDevelopment festgelegt.Automatically set to InDevelopment on creation. Unter Schemaerweiterungen finden Sie weitere Informationen zu den möglichen Statusübergängen und Verhaltensweisen.Schema extensions provides more information on the possible state transitions and behaviors.
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. Zur Auswahl stehen contact, device, event, group, message, organization, post und user.Select from contact, device, event, group, message, organization, post, or user.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

{
  "description": "String",
  "id": "String (identifier)",
  "owner": "String",
  "properties": [{"@odata.type": "microsoft.graph.extensionSchemaProperty"}],
  "status": "String",
  "targetTypes": ["String"]
}