Créer emailAuthenticationMethodCreate emailAuthenticationMethod

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Définir l’objet emailAuthenticationMethod d’un utilisateur.Set a user's emailAuthenticationMethod object. L’authentification de messagerie est une méthode de réinitialisation de mot de passe en libre-service.Email authentication is a self-service password reset method. Un utilisateur ne peut avoir qu’une seule méthode d’authentification de messagerie.A user may only have one email authentication method.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations agissant sur Self (du plus élevé au moins privilégié)Permissions acting on self (from most to least privileged) Autorisations agissant sur d’autres utilisateurs (de la moins à la plus privilégiée)Permissions acting on others (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Non prise en charge.Not supported. UserAuthenticationMethod. ReadWrite. AllUserAuthenticationMethod.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported. Non prise en charge.Not supported.
ApplicationApplication Non prise en charge.Not supported. Non prise en charge.Not supported.

Pour les scénarios délégués pour lesquels un administrateur agit sur un autre utilisateur, l’administrateur a besoin de l’un des rôlessuivants :For delegated scenarios where an admin is acting on another user, the admin needs one of the following roles:

  • Administrateur globalGlobal admin
  • Lecteur généralGlobal reader
  • Administrateur d'authentification privilégiéPrivileged authentication admin
  • Administrateur d'authentificationAuthentication admin

Requête HTTPHTTP request

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

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obligatoire.application/json. Required.

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON de l’objet emailAuthenticationMethod avec l’adresse de messagerie souhaitée.In the request body, supply a JSON representation of the emailAuthenticationMethod object with the desired email address.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez le emailAuthenticationMethod.The following table shows the properties that are required when you create the emailAuthenticationMethod.

PropriétéProperty TypeType DescriptionDescription
emailAddressemailAddress StringString Adresse e-mailEmail address

RéponseResponse

Si elle réussit, cette méthode renvoie un 201 Created Code de réponse et un nouvel objet emailAuthenticationMethod dans le corps de la réponse.If successful, this method returns a 201 Created response code and a new emailAuthenticationMethod object in the response body.

ExemplesExamples

DemandeRequest

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

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

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.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"
}