Löschen eines Benutzerkontos für einen Kunden
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