Freigeben über


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"
}