Wiederherstellen eines gelöschten Benutzers für einen Kunden

Wiederherstellen eines gelöschten Benutzers nach Kunden-ID und Benutzer-ID.

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

  • Die Benutzer-ID. Wenn Sie nicht über die Benutzer-ID verfügen, lesen Sie "Gelöschte Benutzer für einen Kunden anzeigen".

GDAP-Rollen

Sie benötigen mindestens eine der folgenden GDAP-Rollen:

  • Benutzeradministrator
  • Verzeichnis schreiben

Wiederherstellen eines gelöschten Benutzerkontos

Der Benutzerstatus wird beim Löschen eines Benutzerkontos auf "inaktiv" festgelegt. Es bleibt auf diese Weise 30 Tage lang, nach denen das Benutzerkonto und die zugehörigen Daten gelöscht und nicht wiederhergestellt werden können. Sie können während dieses 30-Tage-Fensters nur ein gelöschtes Benutzerkonto wiederherstellen. Nachdem das Benutzerkonto gelöscht und als "inaktiv" gekennzeichnet wurde, wird das Benutzerkonto nicht mehr als Mitglied der Benutzersammlung zurückgegeben (z. B. mithilfe von Get a list of all user accounts for a customer).

C#

Um einen Benutzer wiederherzustellen, erstellen Sie eine neue Instanz der CustomerUser-Klasse, und legen Sie den Wert der User.State-Eigenschaft auf UserState.Active fest.

Sie stellen einen gelöschten Benutzer wieder her, indem Sie den Status des Benutzers auf "aktiv" festlegen. Sie müssen die verbleibenden Felder in der Benutzerressource nicht erneut auffüllen. Diese Werte werden automatisch aus der gelöschten, inaktiven Benutzerressource wiederhergestellt. Verwenden Sie als Nächstes die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID, um den Kunden zu identifizieren, und die Users.ById-Methode, um den Benutzer zu identifizieren.

Rufen Sie schließlich die Patch-Methode auf, und übergeben Sie die CustomerUser-Instanz , um die Anforderung zum Wiederherstellen des Benutzers zu senden.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;

var updatedCustomerUser = new CustomerUser()
{
    State = UserState.Active
};

// Restore customer user information.
var restoredCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Patch(updatedCustomerUser);

Beispiel: Konsolentest-App. Projekt: Partner Center SDK Samples Class: CustomerUserRestore.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um die Kunden-ID und Benutzer-ID anzugeben.

Name Typ Erforderlich Beschreibung
customer-tenant-id guid J Der Wert ist eine GUID-formatierte Kundenmandanten-ID , mit der der Händler die Ergebnisse nach einem bestimmten Kunden filtern kann.
Benutzer-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

In dieser Tabelle werden die erforderlichen Eigenschaften im Anforderungstext beschrieben.

Name Typ Erforderlich Beschreibung
State Zeichenfolge J Der Benutzerstatus. Um einen gelöschten Benutzer wiederherzustellen, muss diese Zeichenfolge "aktiv" enthalten.
Attribute Objekt N Enthält "ObjectType": "CustomerUser".

Beispiel für eine Anfrage

PATCH 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: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CorrelationId: 32be760f-8282-4e01-a37b-829c8a700e8a
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 269
Expect: 100-continue

{
    "State": "active",
    "Attributes": {
        "ObjectType": "CustomerUser"
    }
}

REST-Antwort

Bei erfolgreicher Ausführung gibt die Antwort die wiederhergestellten Benutzerinformationen im Antworttext 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 200 OK
Content-Length: 465
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 32be760f-8282-4e01-a37b-829c8a700e8a
MS-RequestId: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CV: ZTeBriO7mEaiM13+.0
MS-ServerId: 101112616
Date: Fri, 20 Jan 2017 22:24:55 GMT

{
    "usageLocation": "US",
    "id": "a45f1416-3300-4f65-9e8d-f123b397a4ea",
    "userPrincipalName": "e83763f7f2204ac384cfcd49f79f2749@dtdemocspcustomer005.onmicrosoft.com",
    "firstName": "Ferdinand",
    "lastName": "Filibuster",
    "displayName": "Ferdinand",
    "userDomainType": "none",
    "state": "active",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerUser"
    }
}