Restaurer un utilisateur supprimé pour un client

Article
09/11/2024

Comment restaurer un utilisateur supprimé par ID client et ID d’utilisateur.

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 utilisateur. Si vous n’avez pas l’ID d’utilisateur, consultez Afficher les utilisateurs supprimés pour un client.

Rôles GDAP

Vous aurez besoin d’au moins l’un des rôles GDAP suivants :

Administrateur d'utilisateurs
Enregistreur d’annuaire

Restaurer un compte d’utilisateur supprimé

L’état utilisateur est défini sur « inactif » lorsque vous supprimez un compte d’utilisateur. Il reste cette façon pendant 30 jours, après quoi le compte d’utilisateur et ses données associées sont vidés et rendus irrécupérables. Vous ne pouvez restaurer qu’un compte d’utilisateur supprimé pendant cette fenêtre de 30 jours. Une fois supprimé et marqué « inactif », le compte d’utilisateur n’est plus retourné en tant que membre de la collection d’utilisateurs (par exemple, en utilisant obtenir la liste de tous les comptes d’utilisateur pour un client).

C#

Pour restaurer un utilisateur, créez une instance de la classe CustomerUser et définissez la valeur de la propriété User.State sur UserState.Active.

Vous restaurez un utilisateur supprimé en définissant l’état de l’utilisateur sur actif. Vous n’avez pas besoin de remplir les champs restants dans la ressource utilisateur. Ces valeurs seront automatiquement restaurées à partir de la ressource utilisateur supprimée et inactive. Ensuite, utilisez la méthode IAggregatePartner.Customers.ById avec l’ID client pour identifier le client et la méthode Users.ById pour identifier l’utilisateur.

Enfin, appelez la méthode Patch et transmettez l’instance CustomerUser pour envoyer la demande de restauration de l’utilisateur.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;

var updatedCustomerUser = new CustomerUser()
{
    State = UserState.Active
};

// Restore customer user information.
var restoredCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Patch(updatedCustomerUser);

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

Demande REST

Syntaxe de la requête

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

Paramètre d’URI

Utilisez les paramètres de requête suivants pour spécifier l’ID client et l’ID utilisateur.

Nom	Type	Obligatoire	Description
id-locataire-client	guid	O	La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats sur 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

Ce tableau décrit les propriétés requises dans le corps de la requête.

Nom	Type	Obligatoire	Description
State	string	O	L’état de l’utilisateur. Pour restaurer un utilisateur supprimé, cette chaîne doit contenir « active ».
Attributs	object	N	Contient « ObjectType » : « CustomerUser ».

Exemple de requête

PATCH 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: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 269
Expect: 100-continue

{
    "State": "active",
    "Attributes": {
        "ObjectType": "CustomerUser"
    }
}

Réponse REST

Si elle réussit, la réponse retourne les informations utilisateur restaurées dans le corps de la réponse.

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 200 OK
Content-Length: 465
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CV: ZTeBriO7mEaiM13+.0
MS-ServerId: 101112616
Date: Fri, 20 Jan 2017 22:24:55 GMT

{
    "usageLocation": "US",
    "id": "a45f1416-3300-4f65-9e8d-f123b397a4ea",
    "userPrincipalName": "e83763f7f2204ac384cfcd49f79f2749@dtdemocspcustomer005.onmicrosoft.com",
    "firstName": "Ferdinand",
    "lastName": "Filibuster",
    "displayName": "Ferdinand",
    "userDomainType": "none",
    "state": "active",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerUser"
    }
}

Partager via