Create attributeSet
Namespace: microsoft.graph
Create ein neues attributSet-Objekt.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | CustomSecAttributeDefinition.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | CustomSecAttributeDefinition.ReadWrite.All | Nicht verfügbar. |
Dem angemeldeten Benutzer muss außerdem mindestens die VerzeichnisrolleAttributdefinitionsadministrator zugewiesen sein. Standardmäßig verfügen der globale Administrator und andere Administratorrollen nicht über Berechtigungen zum Lesen, Definieren oder Zuweisen benutzerdefinierter Sicherheitsattribute.
HTTP-Anforderung
POST /directory/attributeSets
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des attributSet-Objekts an.
Die folgende Tabelle zeigt die Eigenschaften, die Sie konfigurieren können, wenn Sie ein attributset erstellen.
Eigenschaft | Typ | Beschreibung |
---|---|---|
description | String | Beschreibung des Attributsatzes. Kann bis zu 128 Zeichen lang sein und Unicode-Zeichen enthalten. Kann später geändert werden. Optional. |
id | String | Bezeichner für den Attributsatz, der innerhalb eines Mandanten eindeutig ist. 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 beachten. Erforderlich. |
maxAttributesPerSet | Int32 | Maximale Anzahl von benutzerdefinierten Sicherheitsattributen, die in diesem Attributsatz definiert werden können. Der Standardwert ist null . Wenn nicht angegeben, kann der Administrator bis zu maximal 500 aktive Attribute pro Mandant hinzufügen. Kann später geändert werden. Optional. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created
Antwortcode und ein attributSet-Objekt im Antworttext zurück.
Beispiele
Anforderung
Im folgenden Beispiel wird ein neuer Attributsatz namens Engineering
hinzugefügt.
POST https://graph.microsoft.com/v1.0/directory/attributeSets
Content-Type: application/json
{
"id":"Engineering",
"description":"Attributes for engineering team",
"maxAttributesPerSet":25
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directory/attributeSets/$entity",
"description": "Attributes for engineering team",
"id": "Engineering",
"maxAttributesPerSet": 25
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für