Een gebruikersaccount voor een klant verwijderen

  • Artikel

In dit artikel wordt uitgelegd hoe u een bestaand gebruikersaccount voor een klant verwijdert.

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

  • Een gebruikers-id. Als u de gebruikers-id niet hebt, raadpleegt u Een lijst met alle gebruikersaccounts voor een klant ophalen.

Een gebruikersaccount verwijderen

Wanneer u een gebruikersaccount verwijdert, wordt de gebruikersstatus ingesteld op inactief gedurende 30 dagen. Na dertig dagen worden het gebruikersaccount en de bijbehorende gegevens verwijderd en onherstelbaar gemaakt.

U kunt een verwijderd gebruikersaccount voor een klant herstellen als het inactieve account binnen het venster van 30 dagen valt. Wanneer u echter een account herstelt dat is verwijderd en gemarkeerd als inactief, wordt het account niet meer geretourneerd als lid van de gebruikersverzameling (bijvoorbeeld wanneer u een lijst met alle gebruikersaccounts voor een klant krijgt).

GDAP-rollen

U hebt de volgende GDAP-rol nodig:

  • Gebruikersbeheerder

C#

Een bestaand gebruikersaccount van de klant verwijderen:

  1. Gebruik de methode IAggregatePartner.Customers.ById met de klant-id om de klant te identificeren.

  2. Roep de methode Users.ById aan om de gebruiker te identificeren.

  3. Roep de methode Delete aan om de gebruiker te verwijderen en de gebruikersstatus in te stellen op inactief.

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

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

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

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Gebruik de volgende queryparameters om de klant en gebruiker te identificeren.

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

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode een statuscode van 204 geen inhoud .

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