Créer un compte d’utilisateur pour un clientDelete a user account for a customer

S’applique à :Applies to:

  • Espace partenairesPartner Center

Cet article explique comment supprimer un compte d’utilisateur existant pour un client.This article explains how to delete an existing user account for a 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).

  • ID utilisateur.A user ID. Si vous ne disposez pas de l’ID utilisateur, consultez obtenir la liste de tous les comptes d’utilisateur d’un client.If you do not have the user ID, see Get a list of all user accounts for a customer.

Suppression d’un compte d’utilisateurDeleting a user account

Lorsque vous supprimez un compte d’utilisateur, l’état de l’utilisateur est défini sur inactif pendant trente jours.When you delete a user account, the user state is set to inactive for thirty days. Après 30 jours, le compte d’utilisateur et ses données associées sont purgés et rendus irrécupérables.After thirty days, the user account and its associated data are purged and made unrecoverable.

Vous pouvez restaurer un compte d’utilisateur supprimé pour un client si le compte inactif est dans la période de 30 jours.You can restore a deleted user account for a customer if the inactive account is within the thirty day window. Toutefois, lorsque vous restaurez un compte qui a été supprimé et marqué comme étant inactif, le compte n’est plus renvoyé en tant que membre du regroupement utilisateur (par exemple, lorsque vous recevez une liste de tous les comptes d’utilisateur d’un client).However, when you restore an account that was deleted and marked as inactive, the account is no longer returned as a member of the user collection (for example, when you get a list of all user accounts for a customer).

C#C#

Pour supprimer un compte d’utilisateur client existant :To delete an existing customer user account:

  1. Utilisez la méthode collection iaggregatepartner. Customers. méthode BYID avec l’ID client pour identifier le client.Use the IAggregatePartner.Customers.ById method with the customer ID to identify the customer.

  2. Appelez la méthode users. méthode BYID pour identifier l’utilisateur.Call the Users.ById method to identify the user.

  3. Appelez la méthode Delete pour supprimer l’utilisateur et définir l’état utilisateur sur inactif.Call the Delete method to delete the user and set the user state to inactive.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string customerUserIdToDelete;

partnerOperations.Customers.ById(selectedCustomerId).Users.ById(customerUserIdToDelete).Delete();

Exemple: application de test console.Sample: Console test app. Projet: classed’exemples du kit de développement logiciel (SDK) Partner Center : DeleteCustomerUser.csProject: Partner Center SDK Samples Class: DeleteCustomerUser.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de demandeRequest URI
SuppressionDELETE {baseURL}/v1/Customers/{Customer-tenant-ID}/Users/{User-ID} http/1.1{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Paramètres URIURI parameters

Utilisez les paramètres de requête suivants pour identifier le client et l’utilisateur.Use the following query parameters to identify the customer and user.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-tenant-idcustomer-tenant-id GUIDGUID OY La valeur est un client-client-ID au format GUID qui permet au revendeur de filtrer les résultats pour un client donné.The value is a GUID-formatted customer-tenant-id that allows the reseller to filter the results for a given customer.
user-iduser-id GUIDGUID OY 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

DELETE https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CorrelationId: 709c0b80-016c-4662-b29f-697fdf03e87a
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0

Réponse RESTREST response

En cas de réussite, cette méthode retourne un code d’état 204 no content .If successful, this method returns a 204 No Content status code.

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 REST de l’espace partenaires.For the full list, see Partner Center REST Error Codes.

Exemple de réponseResponse example

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: 709c0b80-016c-4662-b29f-697fdf03e87a
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CV: 90KUJA7HKEaG8wHu.0
MS-ServerId: 101112616
Date: Tue, 24 Jan 2017 23:27:18 GMT