Restaurer un utilisateur supprimé pour un clientRestore a deleted user for a customer

S’applique àApplies To

  • Espace partenairesPartner Center

Comment restaurer un utilisateur supprimé à l’aide d’un ID client et d’un ID utilisateur.How to restore a deleted User by customer ID and user ID.

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).

  • Identificateur utilisateur.The user ID. Si vous ne disposez pas de l’ID utilisateur, consultez afficher les utilisateurs supprimés pour un client.If you do not have the user ID, see View deleted users for a customer.

Quand pouvez-vous restaurer un compte d’utilisateur supprimé ?When can you restore a deleted user account?

Lorsque vous supprimez un compte d’utilisateur, l’état de l’utilisateur est défini sur « inactif ».The user state is set to "inactive" when you delete a user account. Elle reste ainsi pendant trente jours, après quoi le compte d’utilisateur et ses données associées sont purgés et rendus irrécupérables.It remains that way for thirty days, after which the user account and its associated data are purged and made unrecoverable. Vous pouvez uniquement restaurer un compte d’utilisateur supprimé pendant cette période de 30 jours.You can only restore a deleted user account during this thirty-day window. Une fois supprimée et marquée comme « inactive », le compte d’utilisateur n’est plus renvoyé en tant que membre du regroupement d’utilisateurs (par exemple, à l’aide de la fonction obtenir une liste de tous les comptes d’utilisateurs d’un client).Once deleted and marked "inactive" the user account is no longer returned as a member of the user collection (for example, using Get a list of all user accounts for a customer).

C#C#

Pour restaurer un utilisateur, créez une nouvelle instance de la classe CustomerUser et définissez la valeur de la propriété User. State sur userState. active.To restore a user, create a new instance of the CustomerUser class, and set the value of the User.State property to UserState.Active.

Vous restaurez un utilisateur supprimé en définissant l’état de l’utilisateur sur actif.You restore a deleted user by setting the user's state to active. Vous n’avez pas besoin de remplir à nouveau les champs restants dans la ressource utilisateur.You do not have to repopulate the remaining fields in the user resource. Ces valeurs seront automatiquement restaurées à partir de la ressource utilisateur inactive supprimée.Those values will automatically be restored from the deleted, inactive user resource. Ensuite, utilisez la méthode collection iaggregatepartner. Customers. méthode BYID avec l’ID client pour identifier le client et la méthode users. méthode BYID pour identifier l’utilisateur.Next, use the IAggregatePartner.Customers.ById method with the customer ID to identify the customer, and the Users.ById method to identify the user.

Enfin, appelez la méthode patch et transmettez l’instance CustomerUser pour envoyer la demande de restauration de l’utilisateur.Finally, call the Patch method and pass the CustomerUser instance to send the request to restore the user.

// 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 console.Sample: Console test app. Projet: classed’exemples du kit de développement logiciel (SDK) Partner Center : CustomerUserRestore.csProject: Partner Center SDK Samples Class: CustomerUserRestore.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
PATCHPATCH {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ètre d’URIURI parameter

Utilisez les paramètres de requête suivants pour spécifier l’ID client et l’ID utilisateur.Use the following query parameters to specify the customer id and user id.

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

Ce tableau décrit les propriétés requises dans le corps de la demande.This table describes the required properties in the request body.

NomName TypeType ObligatoireRequired DescriptionDescription
StateState stringstring OY L’état de l’utilisateur.The user state. Pour restaurer un utilisateur supprimé, cette chaîne doit contenir « active ».To restore a deleted user, this string must contain "active".
AttributsAttributes objectobject NN Contient « ObjectType » : « CustomerUser ».Contains "ObjectType": "CustomerUser".

Exemple de requêteRequest example

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: 32be760f-8282-4e01-a37b-829c8a700e8a
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 RESTREST response

En cas de réussite, la réponse retourne les informations utilisateur restaurées dans le corps de la réponse.If successful, the response returns the restored user information in the response body.

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 200 OK
Content-Length: 465
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 32be760f-8282-4e01-a37b-829c8a700e8a
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"
    }
}