Тип ресурса phoneAuthenticationMethod

Статья
03/26/2023

Пространство имен: 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"
}

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