customSecurityAttributeDefinition-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Ein Objekt, das das Schema eines benutzerdefinierten Sicherheitsattributs (Schlüssel-Wert-Paar) darstellt. Beispielsweise der Name, die Beschreibung, der Datentyp und die zulässigen Werte des benutzerdefinierten Sicherheitsattributs.

Bis zu 500 aktive Objekte können in einem Mandanten definiert werden. Das customSecurityAttributeDefiniton Objekt kann nicht umbenannt oder gelöscht werden, kann jedoch mithilfe des Vorgangs "customSecurityAttributeDefinition aktualisieren" deaktiviert werden. Muss Teil eines Attributsatzes sein.

Methoden

Methode Rückgabetyp Beschreibung
customSecurityAttributeDefinitions auflisten customSecurityAttributeDefinition-Auflistung Dient zum Abrufen einer Liste der customSecurityAttributeDefinition -Objekte und deren Eigenschaften.
customSecurityAttributeDefinition abrufen customSecurityAttributeDefinition Lesen der Eigenschaften und Beziehungen eines customSecurityAttributeDefinition-Objekts.
CustomSecurityAttributeDefinition erstellen customSecurityAttributeDefinition Erstellen sie ein neues customSecurityAttributeDefinition-Objekt.
customSecurityAttributeDefinition aktualisieren customSecurityAttributeDefinition Dient zum Aktualisieren der Eigenschaften eines customSecurityAttributeDefinition-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
attributeSet String Name des Attributsatzes. Groß-/Kleinschreibung wird nicht beachtet.
description String Beschreibung des benutzerdefinierten Sicherheitsattributs. Kann bis zu 128 Zeichen lang sein und Unicode-Zeichen enthalten. Kann später geändert werden.
id String Bezeichner des benutzerdefinierten Sicherheitsattributs, bei dem es sich um eine Kombination aus dem Attributsatznamen und dem benutzerdefinierten Sicherheitsattributnamen handelt, die durch einen Unterstrich ( _ ) getrennt attributeSet name sind. Die id Eigenschaft wird automatisch generiert und kann nicht festgelegt werden. Groß-/Kleinschreibung wird nicht beachtet.
isCollection Boolean Gibt an, ob dem benutzerdefinierten Sicherheitsattribut mehrere Werte zugewiesen werden können. Kann später nicht mehr geändert werden. Wenn type der Wert auf Boolean festgelegt ist, kann er nicht auf isCollection "true" festgelegt werden.
isSearchable Boolesch Gibt an, ob benutzerdefinierte Sicherheitsattributwerte 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 Sicherheitsattributs. 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. Groß-/Kleinschreibung wird nicht beachtet.
status Zeichenfolge Gibt an, ob das benutzerdefinierte Sicherheitsattribut aktiv oder deaktiviert ist. Zulässige Werte sind Available und Deprecated . Kann später geändert werden.
type String Datentyp für die benutzerdefinierten Sicherheitsattributwerte. Unterstützte Typen sind Boolean Integer , und String . Kann später nicht mehr geändert werden.
usePreDefinedValuesOnly Boolean Gibt an, ob dem benutzerdefinierten Sicherheitsattribut nur vordefinierte Werte zugewiesen werden können. Bei Festlegung auf "false" sind Freihandformwerte zulässig. Kann später von "true" in "false" geändert werden, aber nicht von "false" in "true". Wenn type der Wert auf Boolean festgelegt ist, kann er nicht auf usePreDefinedValuesOnly "true" festgelegt werden.

Beziehungen

Beziehung Typ Beschreibung
Allowedvalues allowedValue-Auflistung Werte, die für dieses benutzerdefinierte Sicherheitsattribut vordefiniert sind.

Diese Navigationseigenschaft wird nicht standardmäßig zurückgegeben und muss in einer Abfrage angegeben $expand werden. Beispiel: /directory/customSecurityAttributeDefinitions?$expand=allowedValues.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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