Crear emailAuthenticationMethodCreate emailAuthenticationMethod

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Establecer el objeto emailAuthenticationMethod de un usuario.Set a user's emailAuthenticationMethod object. La autenticación de correo electrónico es un método de restablecimiento de contraseña de autoservicio.Email authentication is a self-service password reset method. Un usuario solo puede tener un método de autenticación de correo electrónico.A user may only have one email authentication method.

PermissionsPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos que actúan por sí solos (de menos a más privilegiados)Permissions acting on self (from least to most privileged) Permisos que actúan en otros (de menos a más privilegiados)Permissions acting on others (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) UserAuthenticationMethod.ReadWriteUserAuthenticationMethod.ReadWrite UserAuthenticationMethod.ReadWrite.AllUserAuthenticationMethod.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported. No admitida.Not supported.
AplicaciónApplication No procede.Not applicable. UserAuthenticationMethod.ReadWrite.AllUserAuthenticationMethod.ReadWrite.All

Para escenarios delegados en los que un administrador actúa en otro usuario, el administrador necesita uno de los siguientes roles:For delegated scenarios where an admin is acting on another user, the admin needs one of the following roles:

  • Administrador globalGlobal admin
  • Administrador de autenticación con privilegiosPrivileged authentication admin
  • Administrador de autenticaciónAuthentication admin

Solicitud HTTPHTTP request

POST /users/{id | userPrincipalName}/authentication/emailMethods

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto emailAuthenticationMethod con la dirección de correo electrónico deseada.In the request body, supply a JSON representation of the emailAuthenticationMethod object with the desired email address.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto emailAuthenticationMethod.The following table shows the properties that are required when you create the emailAuthenticationMethod.

PropiedadProperty TipoType DescriptionDescription
emailAddressemailAddress CadenaString Dirección de correoEmail address

RespuestaResponse

Si se realiza correctamente, este método devuelve un código de respuesta y un 201 Created nuevo objeto emailAuthenticationMethod en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a new emailAuthenticationMethod object in the response body.

EjemplosExamples

SolicitudRequest

POST https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/emailMethods
Content-Type: application/json

{
  "emailAddress": "kim@contoso.com"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.The following is an example of the response.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "id": "3ddfcfc8-9383-446f-83cc-3ab9be4be18f",
  "emailAddress": "kim@contoso.com"
}