Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Обновление номера телефона пользователя, связанного с объектом метода проверки подлинности телефона .
Вы не можете изменить тип телефона. Чтобы изменить тип телефона, добавьте новый номер нужного типа, а затем удалите объект с исходным типом.
Если политика позволяет пользователю использовать SMS для входа и mobile номер изменен, система попытается зарегистрировать номер для использования в этой системе.
Операции самообслуживания не поддерживаются.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | UserAuthMethod-Phone.ReadWrite | UserAuthenticationMethod.ReadWrite.All, UserAuthMethod-Phone.ReadWrite.All, UserAuthenticationMethod.ReadWrite |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | UserAuthenticationMethod.ReadWrite.All | UserAuthMethod-Phone.ReadWrite.All |
Важно!
Для делегированного доступа с использованием рабочих или учебных учетных записей, в которых пользователь, выполнив вход, работает с другим пользователем, ему должна быть назначена поддерживаемая Microsoft Entra роль или настраиваемая роль, которая предоставляет разрешения, необходимые для этой операции. Эта операция поддерживает следующие встроенные роли, которые предоставляют только минимальные необходимые привилегии:
- Администратор проверки подлинности
- Привилегированный администратор проверки подлинности
Когда пользователи управляют собственными методами проверки подлинности, система предлагает им выполнить многофакторную проверку подлинности (MFA), если они в последний раз прошли проверку подлинности более 10 минут назад в текущем сеансе.
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