Erstellen von identityUserFlowAttribute
Namespace: microsoft.graph
Erstellen Sie ein neues benutzerdefiniertes identityUserFlowAttribute-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) | IdentityUserFlow.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | IdentityUserFlow.ReadWrite.All | Nicht verfügbar. |
Für delegierte Szenarien benötigt der Administrator mindestens die Microsoft Entra-RolleDes Attributadministrators für externe ID-Benutzerflows.
HTTP-Anforderung
POST /identity/userFlowAttributes
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 von identityUserFlowAttribute an.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Der Bezeichner des Benutzerablaufattributs. Dies ist ein schreibgeschütztes Attribut, das automatisch erstellt wird. |
displayName | String | Der Anzeigename des Benutzerablaufattributs. |
description | Zeichenfolge | Die Beschreibung des Benutzerflow-Attributs. Es wird dem Benutzer zum Zeitpunkt der Registrierung angezeigt. |
userFlowAttributeType | Zeichenfolge | Der Typ des Benutzerablaufattributs. Dies ist ein schreibgeschütztes Attribut, das automatisch festgelegt wird. Abhängig vom Typ des Attributs sind builtIn die Werte für diese Eigenschaft oder custom . |
dataType | String | Der Datentyp des Benutzerablaufattributs. Dies kann nicht mehr geändert werden, nachdem das benutzerdefinierte Benutzerflow-Attribut erstellt wurde. Die unterstützten Werte für dataType lauten wie folgt:
|
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und das IdentityUserFlowAttribute-Objekt im Antworttext zurückgegeben. Wenn der Fehler nicht erfolgreich ist, wird ein 4xx
Fehler mit bestimmten Details zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/identity/userFlowAttributes
Content-type: application/json
{
"displayName": "Hobby",
"description": "Your hobby",
"dataType": "string"
}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Location: "/identity/userFlowAttributes('extension_d09380e2b4c642b9a203fb816a04a7ad_Hobby')"
Content-type: application/json
{
"id": "extension_d09380e2b4c642b9a203fb816a04a7ad_Hobby",
"displayName": "Hobby",
"description": "Your hobby",
"userFlowAttributeType": "custom",
"dataType": "string"
}
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