Een verwijderde gebruiker voor een klant herstellen

Artikel
03/06/2024

Een verwijderde gebruiker herstellen op basis van klant-id en gebruikers-id.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De gebruikers-id. Als u de gebruikers-id niet hebt, raadpleegt u Verwijderde gebruikers voor een klant weergeven.

GDAP-rollen

U hebt ten minste een van de volgende GDAP-rollen nodig:

Gebruikersbeheerder
Mapschrijver

Een verwijderd gebruikersaccount herstellen

De gebruikersstatus wordt ingesteld op 'inactief' wanneer u een gebruikersaccount verwijdert. Het blijft zo 30 dagen, waarna het gebruikersaccount en de bijbehorende gegevens worden verwijderd en onherstelbaar worden gemaakt. U kunt alleen een verwijderd gebruikersaccount herstellen tijdens dit 30-daagse venster. Zodra het gebruikersaccount is verwijderd en gemarkeerd als 'inactief', wordt het gebruikersaccount niet meer geretourneerd als lid van de gebruikersverzameling (bijvoorbeeld door een lijst met alle gebruikersaccounts voor een klant op te halen).

C#

Als u een gebruiker wilt herstellen, maakt u een nieuw exemplaar van de klasse CustomerUser en stelt u de waarde van de eigenschap User.State in op UserState.Active.

U herstelt een verwijderde gebruiker door de status van de gebruiker in te stellen op actief. U hoeft de resterende velden in de gebruikersresource niet opnieuw te vullen. Deze waarden worden automatisch hersteld uit de verwijderde, inactieve gebruikersresource. Gebruik vervolgens de methode IAggregatePartner.Customers.ById met de klant-id om de klant te identificeren en de methode Users.ById om de gebruiker te identificeren.

Roep tot slot de Patch-methode aan en geef het CustomerUser-exemplaar door om de aanvraag te verzenden om de gebruiker te herstellen.

// 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);

Voorbeeld: consoletest-app. Project: Voorbeeldklasse Partner Center SDK: CustomerUserRestore.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Gebruik de volgende queryparameters om de klant-id en gebruikers-id op te geven.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	Y	De waarde is een door de klant opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant.
user-id	Guid	Y	De waarde is een gebruikers-id met EEN GUID-indeling die deel uitmaakt van één gebruikersaccount.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de vereiste eigenschappen in de aanvraagbody beschreven.

Naam	Type	Vereist	Beschrijving
Provincie	tekenreeks	Y	De gebruikersstatus. Als u een verwijderde gebruiker wilt herstellen, moet deze tekenreeks 'actief' bevatten.
Kenmerken	object	N	Bevat 'ObjectType': 'CustomerUser'.

Aanvraagvoorbeeld

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"
    }
}

REST-antwoord

Als dit lukt, retourneert het antwoord de herstelde gebruikersgegevens in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

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"
    }
}

Delen via