customSecurityAttributeDefinition-Ressourcentyp

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.

Stellt das Schema eines benutzerdefinierten Sicherheitsattributes (Schlüssel-Wert-Paar) dar. Beispiel: Name, Beschreibung, Datentyp und zulässige Werte für benutzerdefinierte Sicherheitsattribute.

Sie können bis zu 500 aktive Objekte in einem Mandanten definieren. Das customSecurityAttributeDefinition-Objekt kann nicht umbenannt oder gelöscht werden, aber es kann mithilfe des Vorgangs update customSecurityAttributeDefinition deaktiviert werden. Muss Teil eines attributeSets sein.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
List	customSecurityAttributeDefinition-Auflistung	Ruft eine Liste der customSecurityAttributeDefinition-Objekte und deren Eigenschaften ab.
Get	customSecurityAttributeDefinition	Liest die Eigenschaften und Beziehungen eines customSecurityAttributeDefinition-Objekts .
Create	customSecurityAttributeDefinition	Erstellen Sie ein neues customSecurityAttributeDefinition-Objekt .
Update	customSecurityAttributeDefinition	Aktualisieren sie die Eigenschaften eines customSecurityAttributeDefinition-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
attributeSet	Zeichenfolge	Name des Attributsatzes. Schreibungsunabhängig.
description	Zeichenfolge	Beschreibung des benutzerdefinierten Sicherheitsattributes. Kann bis zu 128 Zeichen lang sein und Unicode-Zeichen enthalten. Kann später geändert werden.
id	Zeichenfolge	Bezeichner des benutzerdefinierten Sicherheitsattributes, bei dem es sich um eine Kombination aus dem Namen des Attributsatzes und dem namen des benutzerdefinierten Sicherheitsattributes handelt, die durch einen Unterstrich (attributeSet_name) getrennt sind. Die Id-Eigenschaft wird automatisch generiert und kann nicht festgelegt werden. Schreibungsunabhängig. Geerbt von entity.
isCollection	Boolesch	Gibt an, ob dem benutzerdefinierten Sicherheitsattribute mehrere Werte zugewiesen werden können. Kann später nicht mehr geändert werden. Wenn type auf Booleanfestgelegt ist, kann isCollection nicht auf truefestgelegt werden.
isSearchable	Boolesch	Gibt an, ob benutzerdefinierte Sicherheitsattributewerte für die Suche nach Objekten indiziert werden, denen Attributwerte zugewiesen sind. Kann später nicht mehr geändert werden.
name	Zeichenfolge	Name des benutzerdefinierten Sicherheitsattributes. Muss innerhalb eines Attributsatzes eindeutig sein. Kann bis zu 32 Zeichen lang sein und Unicode-Zeichen enthalten. Darf keine Leerzeichen oder Sonderzeichen enthalten. Kann später nicht mehr geändert werden. Schreibungsunabhängig.
status	Zeichenfolge	Gibt an, ob das benutzerdefinierte Sicherheitsattribute aktiv oder deaktiviert ist. Zulässige Werte sind: Available und Deprecated. Kann später geändert werden.
type	Zeichenfolge	Datentyp für die werte des benutzerdefinierten Sicherheitsattributes. Unterstützte Typen sind: Boolean, Integerund String. Kann später nicht mehr geändert werden.
usePreDefinedValuesOnly	Boolesch	Gibt an, ob dem benutzerdefinierten Sicherheitsattribute nur vordefinierte Werte zugewiesen werden können. Wenn auf falsefestgelegt ist, sind Freiformwerte zulässig. Kann später von true in falsegeändert werden, aber nicht von false in truegeändert werden. Wenn type auf Booleanfestgelegt ist, kann usePreDefinedValuesOnly nicht auf truefestgelegt werden.

Beziehungen

Beziehung	Typ	Beschreibung
allowedValues	allowedValue-Sammlung	Werte, die für dieses benutzerdefinierte Sicherheitsattribute vordefiniert sind. Diese Navigationseigenschaft wird standardmäßig nicht zurückgegeben und muss in einer $expand Abfrage angegeben werden. Beispiel: /directory/customSecurityAttributeDefinitions?$expand=allowedValues.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.customSecurityAttributeDefinition",
  "attributeSet": "String",
  "description": "String",
  "id": "String (identifier)",
  "isCollection": "Boolean",
  "isSearchable": "Boolean",
  "name": "String",
  "status": "String",
  "type": "String",
  "usePreDefinedValuesOnly": "Boolean"
}