Поделиться через


Обновление phoneAuthenticationMethod

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

Важно!

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

Обновите номер телефона, связанный с методом проверки подлинности телефона.

Вы не можете изменить тип телефона. Чтобы изменить тип телефона, добавьте новый номер нужного типа, а затем удалите объект с исходным типом.

Если политика позволяет пользователю использовать SMS для входа и mobile номер изменяется, система пытается зарегистрировать номер для использования в этой системе.

Операции самообслуживания не поддерживаются.

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

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

Разрешения

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

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

Важно!

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

  • Администратор проверки подлинности
  • Привилегированный администратор проверки подлинности

Пользователи не могут обновить собственный метод проверки подлинности на телефоне.

HTTP-запрос

Обновите метод проверки подлинности на телефоне другого пользователя.

PATCH /users/{id | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}

Значение , соответствующее phoneMethodId свойству phoneType для обновления, имеет одно из следующих значений:

  • b6332ec1-7057-4abe-9331-3d72feddfe41 для обновления alternateMobilephoneType.
  • e37fc753-ff3b-4958-9484-eaa9425c82bc для обновления officephoneType.
  • 3179e48a-750b-4051-897c-87b9720928f7 для обновления mobilephoneType.

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

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

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

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

Свойство Тип Описание
phoneNumber String Номер телефона для отправки sms или вызова для проверки подлинности. Номера телефонов используют формат "+<номер>кода><страны x<extension>", с дополнительным расширением. Например, допустимы +1 5555551234 или +1 5555551234x1233. Числа отклоняются при создании или обновлении, если они не соответствуют требуемому формату.
phoneType string Возможные значения: mobile, alternateMobile или office.

Отклик

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

Примеры

Запрос

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

PATCH https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7
Content-type: application/json

{
  "phoneNumber": "+1 2065555554",
  "phoneType": "mobile",
}

Отклик

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

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

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

{
  "phoneNumber": "+1 2065555554",
  "phoneType": "mobile",
  "smsSignInState": "ready",
  "id": "3179e48a-750b-4051-897c-87b9720928f7"
}