Entfernen eines Kundenbenutzers aus einer Rolle

Artikel
09/11/2024

So entfernen Sie einen Benutzer aus einer Verzeichnisrolle innerhalb eines Kundenkontos.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

GDAP-Rollen

Sie benötigen die folgende GDAP-Rolle:

Administrator für privilegierte Rollen

C#

Um einen Benutzer aus einer Verzeichnisrolle zu entfernen, wählen Sie den Kunden mit dem Benutzer aus, der mit einem Aufruf der IAggregatePartner.Customers.ById-Methode geändert werden soll. Geben Sie von dort aus die Rolle mithilfe der DirectoryRoles.ById-Methode mit der Verzeichnisrollen-ID an. Greifen Sie dann auf die UserMembers.ById-Methode zu, um den zu entfernenden Benutzer zu identifizieren, und die Delete-Methode, um den Benutzer aus der Rolle zu entfernen.

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

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

Beispiel: Konsolentest-App. Project: Partner Center SDK Samples Class: RemoveCustomerUserMemberFromDirectoryRole.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie die folgenden URI-Parameter, um den richtigen Kunden, die richtige Rolle und den richtigen Benutzer zu identifizieren.

Name	Typ	Erforderlich	Beschreibung
customer-tenant-id	guid	J	Der Wert ist eine guid formatierte Kundenmandanten-ID , die den Kunden identifiziert.
role-id	guid	J	Der Wert ist eine guiD formatierte Rollen-ID , die die Rolle identifiziert.
Benutzer-ID	guid	J	Der Wert ist eine GUID- formatierte Benutzer-ID , die ein einzelnes Benutzerkonto identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Beispiel für eine Anfrage

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

Wenn der Benutzer erfolgreich aus der Rolle entfernt wird, ist der Antworttext leer.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

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

Freigeben über