Créer des comptes d’utilisateur pour un clientCreate user accounts for a customer

S’applique à :Applies to:

  • Espace partenairesPartner Center

Créez un nouveau compte d’utilisateur pour votre client.Create a new user account for your customer.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.This scenario supports authentication with App+User credentials only.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

Pour obtenir un nouveau compte d’utilisateur pour un client :To obtain a new user account for a customer:

  1. Créez un nouvel objet CustomerUser avec les informations utilisateur appropriées.Create a new CustomerUser object with the relevant user information.

  2. Utilisez votre collection IAggregatePartner.Customers et appelez la méthode ById().Use your IAggregatePartner.Customers collection and call the ById() method.

  3. Appelez la propriété Utilisateurs, suivie de la méthode Créer.Call the Users property, followed by the Create method.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// var SelectedCustomer;

var userToCreate = new CustomerUser()
{
    PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "Password!1" },
    DisplayName = "TestDisplayName",
    FirstName = "TestFirstName",
    LastName = "TestLastName",
    UsageLocation = "US",
    UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
};

User createdUser = partnerOperations.Customers.ById(selectedCustomerId).Users.Create(userToCreate);

Exemple: application de test console.Sample: Console test app. Projet: PartnerSDK. FeatureSamples, classe: CustomerUserCreate.csProject: PartnerSDK.FeatureSamples Class: CustomerUserCreate.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-tenant-ID}/Users http/1.1{baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1

Paramètres d’URIURI parameters

Pour identifier le client approprié, utilisez les paramètres de requête suivants.Use the following query parameters to identify the correct customer.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-tenant-idcustomer-tenant-id guidguid OY La valeur est un GUID client-ID-client-ID. Il permet au revendeur de filtrer les résultats pour un client donné qui appartient au revendeur.The value is a GUID formatted customer-tenant-id. It allows the reseller to filter the results for a given customer that belongs to the reseller.
ID utilisateuruser-id guidguid NN La valeur est un ID utilisateur au format GUID qui appartient à un compte d’utilisateur unique.The value is a GUID formatted user-id that belongs to a single user account.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
{
      "usageLocation": "country/region code",
      "userPrincipalName": "userid@domain.onmicrosoft.com",
      "firstName": "First",
      "lastName": "Last",
      "displayName": "User name",
      "immutableId": "Some unique ID",
      "passwordProfile":{
                 password: "abCD123*",
                 forceChangePassword: true
      },
      "attributes": {
        "objectType": "CustomerUser"
      }
}

Réponse RESTREST response

En cas de réussite, cette méthode retourne un compte d’utilisateur, y compris le GUID.If successful, this method returns a user account, including the GUID.

Codes d’erreur et de réussite de la réponseResponse success and error codes

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST

{
  "usageLocation": "country/region code",
  "id": "4b10bf41-ab11-40e3-8c53-cd67849b50de",
  "userPrincipalName": "userid@domain.onmicrosoft.com",
  "firstName": "First",
  "lastName": "Last",
  "displayName": "User name",
  "immutableId": "Some unique ID",
  "passwordProfile": {
    "forceChangePassword": true,
    "password": "abCD123*"
  },
  "lastDirectorySyncTime": null,
  "userDomainType": "none",
  "state": "active",
  "softDeletionTime": null,
  "attributes": {
    "objectType": "CustomerUser"
  }
}