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


Обновление phoneAuthenticationMethod

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

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

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

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

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

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

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) UserAuthenticationMethod.ReadWrite.All UserAuthenticationMethod.ReadWrite
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение 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 или вызова для проверки подлинности. Номера телефонов используют формат +{country code} {number}x{extension}, с дополнительным расширением. Например, +1 5555551234 или +1 5555551234x123 допустимы. Числа отклоняются при создании или обновлении, если они не соответствуют требуемому формату.
phoneType string Возможные значения: mobile, alternateMobile или office.

Отклик

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

Примеры

Запрос

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

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

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

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content