Erstellen von userAttributeAssignments

Namespace: microsoft.graph

Erstellen Sie ein neues identityUserFlowAttributeAssignment-Objekt in einem b2cIdentityUserFlow.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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
Application IdentityUserFlow.ReadWrite.All Nicht verfügbar.

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. External ID User Flow Administrator ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird.

HTTP-Anforderung

POST /identity/b2cUserFlows/{id}/userAttributeAssignments

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des identityUserFlowAttributeAssignment-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die erforderlich sind, wenn Sie identityUserFlowAttributeAssignment erstellen.

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Anzeigename des identityUserFlowAttribute innerhalb eines Benutzerflusses.
isOptional Boolean Bestimmt, ob das identityUserFlowAttribute optional ist. true bedeutet, dass der Benutzer keinen Wert angeben muss. false bedeutet, dass der Benutzer die Registrierung nicht abschließen kann, ohne einen Wert anzugeben.
requiresVerification Boolean Bestimmt, ob das identityUserFlowAttribute überprüft werden muss. Dies dient nur zur Überprüfung der Telefonnummer oder E-Mail-Adresse des Benutzers.
userAttributeValues userAttributeValuesItem collection Die Eingabeoptionen für das Benutzerflussattribut. Nur anwendbar, wenn userInputType , radioSingleSelectdropdownSingleSelectoder checkboxMultiSelectist.
userInputType identityUserFlowAttributeInputType Der Eingabetyp des Benutzerflussattributs. Mögliche Werte sind: textBox, dateTimeDropdown, radioSingleSelect, dropdownSingleSelect, emailBox, checkboxMultiSelect.
userAttribute identityUserFlowAttribute Der Bezeichner für das Benutzerflussattribut, das in die Benutzerflusszuweisung aufgenommen werden soll.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein identityUserFlowAttributeAssignment-Objekt im Antworttext zurück.

Beispiele

Anforderung

POST https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_Consumer/userAttributeAssignments
Content-Type: application/json

{
    "isOptional": false,
    "requiresVerification": false,
    "userInputType": "TextBox",
    "displayName": "Shoe size",
    "userAttributeValues": [],
    "userAttribute": {
        "id": "extension_guid_shoeSize"
    }
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/identity/b2xUserFlows/B2C_1_Consumer/userAttributeAssignments/extension_guid_shoeSize
Content-Type: application/json

{
    "id": "extension_guid_shoeSize",
    "isOptional": false,
    "requiresVerification": false,
    "userInputType": "TextBox",
    "displayName": "Shoe size",
    "userAttributeValues": []
}