Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Создайте пользовательский объект identityUserFlowAttribute .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | IdentityUserFlow.ReadWrite.All | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | IdentityUserFlow.ReadWrite.All | Недоступно. |
Важно!
Для делегированного доступа с использованием рабочих или учебных учетных записей вошедшего пользователя должен быть владельцем или членом группы либо ему должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль, которая предоставляет разрешения, необходимые для этой операции. Внешняя идентификация администратор атрибутов потока пользователей является наименее привилегированной ролью, поддерживаемой для этой операции.
HTTP-запрос
POST /identity/userFlowAttributes
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление identityUserFlowAttribute в формате JSON.
| Свойство | Тип | Описание |
|---|---|---|
| id | String | Идентификатор атрибута потока пользователей. Это автоматически созданный атрибут только для чтения. |
| displayName | String | Отображаемое имя атрибута потока пользователей. |
| description | String | Описание атрибута потока пользователя. Он отображается пользователю во время регистрации. |
| userFlowAttributeType | String | Тип атрибута потока пользователей. Это автоматически настроенный атрибут только для чтения. В зависимости от типа атрибута для этого свойства используются builtIn значения или custom. |
| dataType | String | Тип данных атрибута потока пользователей. Это невозможно изменить после создания атрибута пользовательского потока. Поддерживаемые значения для dataType:
|
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект identityUserFlowAttribute в теле отклика. В случае неудачи 4xx возвращается ошибка с определенными сведениями.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/v1.0/identity/userFlowAttributes
Content-type: application/json
{
"displayName": "Hobby",
"description": "Your hobby",
"dataType": "string"
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
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"
}