Créer un compte d’utilisateur pour un client

Article
09/11/2024

Cet article explique comment supprimer un compte d’utilisateur existant pour un client.

Prerequisites

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).
ID d’utilisateur. Si vous n’avez pas l’ID d’utilisateur, consultez Obtenir la liste de tous les comptes d’utilisateur d’un client.

Suppression d’un compte d’utilisateur

Lorsque vous supprimez un compte d’utilisateur, l’état utilisateur est défini sur inactif pendant 30 jours. Après trente 30 jours, le compte d’utilisateur et ses données associées sont vidés et rendus irrécupérables.

Vous pouvez restaurer un compte d’utilisateur supprimé pour un client si le compte inactif se trouve dans la fenêtre de 30 jours. Toutefois, lorsque vous restaurez un compte qui a été supprimé et marqué comme inactif, le compte n’est plus retourné en tant que membre de la collection d’utilisateurs (par exemple, lorsque vous obtenez une liste de tous les comptes d’utilisateur pour un client).

Rôles GDAP

Vous aurez besoin du rôle GDAP suivant :

Administrateur d'utilisateurs

C#

Pour supprimer un compte d’utilisateur client existant :

Utilisez la méthode IAggregatePartner.Customers.ById avec l’ID client, pour identifier le client.
Appelez la méthode Users.ById pour identifier l’utilisateur.
Appelez la méthode Supprimer pour supprimer l’utilisateur et définir l’état utilisateur sur inactif.

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

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

Exemple : Application de test de console. Projet : Classe d’exemples sdk de l’Espace partenaires : DeleteCustomerUser.cs

Demande REST

Syntaxe de la requête

Method	URI de demande
Suppression	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Paramètres d’URI

Utilisez les paramètres de requête suivants pour identifier le client et l’utilisateur.

Nom	Type	Obligatoire	Description
customer-tenant-id	GUID	O	La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné.
user-id	GUID	O	La valeur est un ID d’utilisateur au format GUID qui appartient à un seul compte d’utilisateur.

En-têtes de demande

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucun.

Exemple de requête

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0

Réponse REST

Si elle réussit, cette méthode retourne un code d’état 204 Aucun contenu .

Codes d’erreur et de réussite de la réponse

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. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CV: 90KUJA7HKEaG8wHu.0
MS-ServerId: 101112616
Date: Tue, 24 Jan 2017 23:27:18 GMT

Partager via