Obtener emailAuthenticationMethod
Espacio de nombres: microsoft.graph
Recupere el objeto de método de autenticación de correo electrónico único de un usuario.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Permisos que actúan por sí mismo
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | No admitida. |
Permisos que actúan en otros usuarios
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
Importante
En escenarios delegados con cuentas profesionales o educativas en las que el usuario que ha iniciado sesión actúa sobre otro usuario, se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación.
- Lector global
- Administrador de autenticación
- Administrador de autenticación con privilegios
Solicitud HTTP
El identificador del método de autenticación de {emailMethods-id}correo electrónico, al que hace referencia , siempre 3ddfcfc8-9383-446f-83cc-3ab9be4be18fes .
Obtenga detalles de su propio método de autenticación por correo electrónico.
GET /me/authentication/emailMethods/{emailMethods-id}
Obtenga detalles de su propio método de autenticación de correo electrónico o de otro usuario.
GET /users/{id | userPrincipalName}/authentication/emailMethods/{emailMethods-id}
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y el objeto emailAuthenticationMethod solicitado en el cuerpo de la respuesta.
Ejemplos
Solicitud
GET https://graph.microsoft.com/v1.0/me/authentication/emailMethods/3ddfcfc8-9383-446f-83cc-3ab9be4be18f
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": {
"id": "3ddfcfc8-9383-446f-83cc-3ab9be4be18f",
"emailAddress": "Kim@contoso.com"
}
}