Löschen eines Benutzerkontos für einen Kunden

Artikel
03/06/2024

In diesem Artikel wird erläutert, wie Sie ein vorhandenes Benutzerkonto für einen Kunden löschen.

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).
Eine Benutzer-ID. Wenn Sie nicht über die Benutzer-ID verfügen, lesen Sie " Abrufen einer Liste aller Benutzerkonten für einen Kunden".

Löschen eines Benutzerkontos

Wenn Sie ein Benutzerkonto löschen, wird der Benutzerstatus für 30 Tage auf "inaktiv " festgelegt. Nach 30 Tagen werden das Benutzerkonto und die zugehörigen Daten gelöscht und nicht wiederhergestellt.

Sie können ein gelöschtes Benutzerkonto für einen Kunden wiederherstellen, wenn sich das inaktive Konto innerhalb des 30-Tage-Fensters befindet. Wenn Sie jedoch ein Konto wiederherstellen, das gelöscht und als inaktiv gekennzeichnet wurde, wird das Konto nicht mehr als Mitglied der Benutzersammlung zurückgegeben (z. B. wenn Sie eine Liste aller Benutzerkonten für einen Kunden erhalten).

GDAP-Rollen

Sie benötigen die folgende GDAP-Rolle:

Benutzeradministrator

C#

So löschen Sie ein vorhandenes Kundenbenutzerkonto:

Verwenden Sie die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID, um den Kunden zu identifizieren.
Rufen Sie die Users.ById-Methode auf, um den Benutzer zu identifizieren.
Rufen Sie die Delete-Methode auf, um den Benutzer zu löschen und den Benutzerstatus auf inaktiv zu setzen.

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

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

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

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um den Kunden und den Benutzer zu identifizieren.

Name	Typ	Erforderlich	Beschreibung
customer-tenant-id	GUID	J	Der Wert ist eine GUID-formatierte Kundenmandanten-ID , mit der der Händler die Ergebnisse für einen bestimmten Kunden filtern kann.
user-id	GUID	J	Der Wert ist eine GUID-formatierte Benutzer-ID , die zu einem einzelnen Benutzerkonto gehört.

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

Bei erfolgreicher Ausführung gibt die Methode den Code "204 Kein Inhalt " zurück.

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

Share via