Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representación de un teléfono registrado a nombre de un usuario. Este recurso incluye el número de teléfono, el tipo de teléfono y si el teléfono está configurado para que el usuario inicie sesión a través de SMS.
Un teléfono tiene uno de tres tipos: móvil, móvil alternativo u oficina. Un usuario puede tener un número registrado para cada tipo y debe tener un teléfono móvil antes de que se agregue un teléfono móvil alternativo. Cuando se usa un teléfono para la autenticación multifactor (MFA) o el autoservicio de restablecimiento de contraseña (SSPR), el teléfono móvil es el predeterminado y el teléfono móvil alternativo es la copia de seguridad.
Los teléfonos móviles principales se pueden usar tanto para SMS como para llamadas de voz, dependiendo de la configuración del inquilino.
Un teléfono de la oficina solo puede recibir llamadas de voz, no mensajes SMS.
Se trata de un tipo derivado que hereda del tipo de recurso authenticationMethod .
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | phoneAuthenticationMethod | Read las propiedades y relaciones de todos los objetos phoneAuthenticationMethod de este usuario. |
| Get | phoneAuthenticationMethod | Lea las propiedades y relaciones del objeto phoneAuthenticationMethod. |
| Add | phoneAuthenticationMethod | Crear el objeto phoneAuthenticationMethod de un usuario. |
| Actualizar | phoneAuthenticationMethod | Actualice el objeto phoneAuthenticationMethod. |
| Delete | Ninguno | Eliminar el objeto phoneAuthenticationMethod. |
| Deshabilitar el inicio de sesión mediante SMS | Ninguno | Desactivar el inicio de sesión mediante SMS para un usuario. |
| Habilitar el inicio de sesión mediante SMS | Ninguno | Activar el inicio de sesión mediante SMS para un usuario. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| createdDateTime | DateTimeOffset | La fecha y hora en que se registró el método de autenticación para el usuario. Solo lectura. Opcional. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| lastUsedDateTime | DateTimeOffset | La fecha y hora en que el usuario usó por última vez el método de autenticación. Solo lectura. Opcional. Este valor opcional se produce null si el método de autenticación no lo rellena. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Heredado de authenticationMethod. |
| id | Cadena | El identificador de este teléfono registrado a nombre de este usuario. Solo lectura. El valor de ID es uno de los siguientes:
|
| phoneNumber | Cadena | El número de teléfono al que se va a enviar un mensaje de texto o llamar para la autenticación. Los números de teléfono tienen el formato "+<número de código>><de país x<extensión>", con extensión opcional. Por ejemplo, +1 5555551234 o +1 5555551234x123 son válidos. Los números se rechazan al crear o actualizar si no coinciden con el formato requerido. |
| phoneType | authenticationPhoneType | El tipo de este teléfono. Los valores posibles son: mobile, alternateMobile, o office. |
| smsSignInState | authenticationMethodSignInState | Si un teléfono está listo para usarse para el inicio de sesión mediante SMS o no. Los valores posibles son: notSupported, notAllowedByPolicy, notEnabled, phoneNumberNotUniqueready, o , unknownFutureValue.notConfigured |
valores authenticationPhoneType
Los teléfonos pueden ser de tres tipos, los siguientes son los valores posibles.
| Valor | Descripción |
|---|---|
| móvil | Un teléfono móvil principal, utilizable para SMS y llamadas de voz. |
| alternativa móvil | Un teléfono móvil alternativo o de respaldo, utilizable solo para llamadas de voz. |
| oficina | Un teléfono de oficina o fijo, utilizable solo para llamadas de voz. |
valores de authenticationMethodSignInState
La propiedad de estado de inicio de sesión mediante SMS proporciona información sobre si un número de teléfono está listo o no para iniciar sesión a través de SMS. Los siguientes son los valores posibles.
| Valor | Descripción |
|---|---|
| notSupported | El inicio de sesión principal no se admite con este método de autenticación: por ejemplo, el inicio de sesión solo se puede habilitar en el número de móvil principal de un usuario, no en el número alternativo. |
| notAllowedByPolicy | Este usuario no está habilitado por la directiva para usar este método como inicio de sesión principal. |
| no configurado | Este usuario está habilitado por la directiva para usar este método como inicio de sesión principal, pero debe realizar más acciones para configurarlo. |
| phoneNumberNotUnique | Este usuario intentó configurar un número de teléfono como inicio de sesión principal, pero el número no era único y no se puede usar como nombre de inicio de sesión. |
| listo | Este método de autenticación está listo para usarse en el inicio de sesión principal. |
| notEnabled | Este método de inicio de sesión no está habilitado |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
"createdDateTime": "String (timestamp)",
"lastUsedDateTime": "String (timestamp)",
"id": "String (identifier)",
"phoneNumber": "String",
"phoneType": "string",
"smsSignInState": "string"
}