Créer emailAuthenticationMethodCreate emailAuthenticationMethod

• 14/10/2020
• 2 minutes de lecture
• • 
  • 

Espace de noms: microsoft.graphNamespace: microsoft.graph

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.

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

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.

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"
}

const options = {
    authProvider,
};

const client = Client.init(options);

const emailAuthenticationMethod = {
  emailAddress: "kim@contoso.com"
};

let res = await client.api('/users/kim@contoso.com/authentication/emailMethods')
    .version('beta')
    .post(emailAuthenticationMethod);

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/kim@contoso.com/authentication/emailMethods"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphEmailAuthenticationMethod *emailAuthenticationMethod = [[MSGraphEmailAuthenticationMethod alloc] init];
[emailAuthenticationMethod setEmailAddress:@"kim@contoso.com"];

NSError *error;
NSData *emailAuthenticationMethodData = [emailAuthenticationMethod getSerializedDataWithError:&error];
[urlRequest setHTTPBody:emailAuthenticationMethodData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

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"
}