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

Тип ресурса phoneAuthenticationMethod

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

Важно!

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

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

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

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

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

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

Методы

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

Свойства

Свойство Тип Описание
createdDateTime DateTimeOffset Дата и время регистрации метода проверки подлинности для пользователя. Только для чтения. Необязательный параметр. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
lastUsedDateTime DateTimeOffset Дата и время последнего использования метода проверки подлинности пользователем. Только для чтения. Необязательный параметр. Это необязательное значение , null если метод проверки подлинности не заполняет его. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Наследуется от authenticationMethod.
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 или вызова для проверки подлинности. Номера телефонов используют формат "+<номер>кода><страны x<extension>", с дополнительным расширением. Например, допустимы +1 5555551234 или +1 5555551234x1233. Числа отклоняются при создании или обновлении, если они не соответствуют требуемому формату.
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",
  "createdDateTime": "String (timestamp)",
  "lastUsedDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}
  • Last updated on