Share via

user: convertExternalToInternalMemberUser

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Преобразование пользователя, прошедшего внешнюю проверку подлинности, во внутреннего пользователя. Пользователь может войти в клиент узла в качестве внутреннего пользователя и получить доступ к ресурсам в качестве участника. Дополнительные сведения об этом преобразовании см. в разделе Преобразование внешних пользователей во внутренних пользователей.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) User-ConvertToInternal.ReadWrite.All User.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение User-ConvertToInternal.ReadWrite.All User.ReadWrite.All

В делегированных сценариях вызывающий пользователь должен иметь по крайней мере роли администратора пользователейMicrosoft Entra.

HTTP-запрос

POST /users/{usersId}/convertExternalToInternalMemberUser

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление параметров в формате JSON.

В следующей таблице перечислены параметры, необходимые при вызове этого действия.

Параметр Тип Описание
почта; String Необязательный параметр.
passwordProfile passwordProfile Требуется для пользователей, проверка подлинности которых осуществляется в облаке.
userPrincipalName String Требуется, чтобы облачные пользователи изменили userPrincipalName. Не требуется для локальных синхронизированных пользователей, так как их userPrincipalName управляется локально.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект ответа conversionUserDetails .

Примеры

Пример 1. Преобразование пользователя в облако и требование сброса пароля при следующем входе

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser
Content-type: application/json

{
    "userPrincipalName": "AdeleVance@contoso.com",
    "passwordProfile": {
        "password": "Zdi087#2jhkahf",
        "forceChangePasswordNextSignIn": "true"
    }
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.conversionUserDetails",
    "displayName": "Adele Vance",
    "userPrincipalName": "AdeleVance@contoso.com",
    "convertedToInternalUserDateTime": "2024-02-05T20:16:37.5012924Z",
    "mail": "AdeleV@woodgrove.com"
}

Пример 2. Преобразование облачного пользователя, изменение адреса электронной почты и требование сброса пароля при следующем входе

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser
Content-type: application/json

{
    "userPrincipalName": "AdeleVance@contoso.com",
    "passwordProfile": {
        "password": "Zdi087#2jhkahf",
        "forceChangePasswordNextSignIn": "true"
    },
    "mail": "AdeleV@contoso.com"
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.conversionUserDetails",
    "displayName": "Adele Vance",
    "userPrincipalName": "AdeleVance@contoso.com",
    "convertedToInternalUserDateTime": "2024-02-05T20:16:37.5012924Z",
    "mail": "AdeleV@woodgrove.com"
}

Пример 3. Преобразование внешнего пользователя во внутренний для пользователя, синхронизированного из локальной службы AD

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/users/0b8cc234-ef87-4015-9785-cbb42000d41c/convertExternalToInternalMemberUser

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.conversionUserDetails",
    "displayName": "Adele Vance",
    "userPrincipalName": "AdeleVance@contoso.com",
    "convertedToInternalUserDateTime": "2024-02-05T20:16:37.5012924Z",
    "mail": "AdeleV@woodgrove.com"
}

Связанные материалы