Een gebruikersaccount voor een klant verwijderen

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

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt alleen verificatie met app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in het partnercentrumdashboard. Selecteer CSP in het partnercentrummenu, gevolgd door klanten. Selecteer de klant in de lijst met klanten en selecteer 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: 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 stel de gebruikersstatus in op inactief.

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

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

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

REST-aanvraag

Syntaxis van aanvraag

Methode 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 J De waarde is een guid-opgemaakte klant-tenant-id waarmee de reseller de resultaten voor een bepaalde klant kan filteren.
user-id GUID J De waarde is een gebruikers-id met GUID-indeling die deel uitmaakt van één gebruikersaccount.

Aanvraagheaders

Zie Rest-headers in partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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 code van 204 Geen inhoudsstatus .

Antwoord geslaagde en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout is 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.

Voorbeeld van antwoord

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