Een klantgebruiker uit een rol verwijderen

Artikel
09/11/2024

Een gebruiker verwijderen uit een directoryrol binnen een klantaccount.

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

GDAP-rollen

U hebt de volgende GDAP-rol nodig:

Beheerder voor bevoorrechte rollen

C#

Als u een gebruiker uit een directoryrol wilt verwijderen, selecteert u de klant met de gebruiker die u wilt wijzigen met een aanroep naar de methode IAggregatePartner.Customers.ById, van daaruit geeft u de rol op met behulp van de methode DirectoryRoles.ById met de maprol-id. Open vervolgens de methode UserMembers.ById om de gebruiker te identificeren die moet worden verwijderd en de methode Delete om de gebruiker uit de rol te verwijderen.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedRoleId;
// string selectedUserMemberId;

partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedRoleId).UserMembers.ById(selectedUserMemberId).Delete();

Voorbeeld: consoletest-app. Project: Klasse Voorbeelden van Partner Center SDK: RemoveCustomerUserMemberFromDirectoryRole.cs

REST-aanvraag

Aanvraagsyntaxis

Method	Aanvraag-URI
DELETE	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers/{user-ID} HTTP/1.1

URI-parameter

Gebruik de volgende URI-parameters om de juiste klant, rol en gebruiker te identificeren.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	Y	De waarde is een door de klant opgemaakte klant-tenant-id die de klant identificeert.
role-id	Guid	Y	De waarde is een door de GUID opgemaakte rol-id waarmee de rol wordt geïdentificeerd.
user-id	Guid	Y	De waarde is een gebruikers-id met GUID-indeling waarmee één gebruikersaccount wordt geïdentificeerd.

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%20/directoryroles/729827e3-9c14-49f7-bb1b-9608f156bbb8/usermembers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04%20 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0a00ec08-6273-46bb-ab6f-14a13959b381
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0
Connection: Keep-Alive

REST-antwoord

Als de gebruiker is verwijderd uit de rol, is de hoofdtekst van het antwoord leeg.

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e784d7aa-8c8d-45ee-8f97-9e09823d7338
MS-CV: es01VX8do0u2aTXw.0
MS-ServerId: 101112616
Date: Tue, 20 Dec 2016 23:16:35 GMT

Share via