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


Тип ресурса phoneAuthenticationMethod

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

Представляет номер телефона и тип, зарегистрированные для пользователя, а также настроен ли пользователь для входа через SMS.

Телефон имеет один из трех типов: мобильный, альтернативный мобильный или офис. Пользователь может иметь один номер, зарегистрированный для каждого типа, и должен иметь мобильный телефон перед добавлением альтернативного мобильного телефона. При использовании телефона для многофакторной проверки подлинности (MFA) или самостоятельного сброса пароля (SSPR) мобильный телефон используется по умолчанию, а альтернативный мобильный телефон — резервная копия.

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

Офисный телефон может принимать только голосовые звонки, но не SMS-сообщения.

Это производный тип, который наследуется от типа ресурса authenticationMethod .

Методы

Метод Возвращаемый тип Описание
Список phoneAuthenticationMethod Чтение свойств и связей всех объектов phoneAuthenticationMethod этого пользователя.
Получение phoneAuthenticationMethod Чтение свойств и связей объекта phoneAuthenticationMethod для пользователя.
Добавление phoneAuthenticationMethod Create объект phoneAuthenticationMethod пользователя.
Обновление Нет Обновите объект phoneAuthenticationMethod для пользователя.
удаление; Нет Удалите объект phoneAuthenticationMethod для пользователя.
Отключение входа в SMS Нет Отключите вход в SMS для пользователя.
Включение входа в SMS Нет Включите вход в SMS для пользователя.

Свойства

Свойство Тип Описание
id String Идентификатор телефона, зарегистрированного для этого пользователя. Только для чтения.

Идентификатор имеет одно из следующих значений:
  • b6332ec1-7057-4abe-9331-3d72feddfe41— где phoneType — .alternateMobile
  • e37fc753-ff3b-4958-9484-eaa9425c82bc— где phoneType — .office
  • 3179e48a-750b-4051-897c-87b9720928f7— где phoneType — .mobile
phoneNumber String Номер телефона для отправки sms или вызова для проверки подлинности. Номера телефонов используют формат +{country code} {number}x{extension}, с дополнительным расширением. Например, +1 5555551234 или +1 5555551234x123 допустимы. Числа отклоняются при создании или обновлении, если они не соответствуют требуемому формату.
phoneType authenticationPhoneType Тип этого телефона. Возможные значения: mobile, alternateMobile или office.
smsSignInState authenticationMethodSignInState Готов ли телефон к использованию для входа в SMS или нет. Возможные значения: notSupported, notAllowedByPolicy, notEnabled, phoneNumberNotUnique, readyили notConfigured, . unknownFutureValue

значения authenticationPhoneType

Телефоны могут быть трех типов. Ниже приведены возможные значения.

Значение Описание
мобильный Основной мобильный телефон, который можно использовать для SMS и голосовых звонков.
alternateMobile Альтернативный или резервный мобильный телефон, который можно использовать только для голосовых звонков.
office Офисный или стационарный телефон, который можно использовать только для голосовых звонков.

Значения authenticationMethodSignInState

Свойство состояния входа SMS предоставляет сведения о том, готов ли номер телефона для входа через SMS. Ниже приведены возможные значения.

Значение Описание
notSupported Основной вход не поддерживается в этом методе проверки подлинности. Например, вход можно включить только по основному номеру мобильного телефона пользователя, но не по альтернативному номеру.
notAllowedByPolicy Политика не позволяет этому пользователю использовать этот метод в качестве основного входа.
NotConfigured Политика позволяет этому пользователю использовать этот метод в качестве основного входа, но для его настройки необходимо предпринять дальнейшие действия.
phoneNumberNotUnique Этот пользователь попытался настроить номер телефона в качестве основного входа, но номер не был уникальным и не может использоваться в качестве имени для входа.
Готов Этот метод проверки подлинности готов к использованию при основном входе.
notEnabled Этот метод входа не включен

Связи

Отсутствуют.

Представление JSON

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

{
  "@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}