Udostępnij za pośrednictwem


Przywracanie usuniętego użytkownika dla klienta

Jak przywrócić usuniętego użytkownika według identyfikatora klienta i identyfikatora użytkownika.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

  • Identyfikator użytkownika. Jeśli nie masz identyfikatora użytkownika, zobacz Wyświetlanie usuniętych użytkowników dla klienta.

Role GDAP

Będziesz potrzebować co najmniej jednej z następujących ról GDAP:

  • Administrator użytkowników
  • Składnik zapisywania katalogów

Przywracanie usuniętego konta użytkownika

Stan użytkownika jest ustawiony na "nieaktywny" po usunięciu konta użytkownika. Pozostaje w ten sposób przez 30 dni, po którym konto użytkownika i skojarzone z nim dane są czyszczone i nie do odzyskania. W tym 30-dniowym oknie można przywrócić usunięte konto użytkownika. Po usunięciu i oznaczeniu jako "nieaktywne" konto użytkownika nie jest już zwracane jako członek kolekcji użytkowników (na przykład przy użyciu opcji Pobierz listę wszystkich kont użytkowników dla klienta).

C#

Aby przywrócić użytkownika, utwórz nowe wystąpienie klasy CustomerUser i ustaw wartość właściwości User.State na UserState.Active.

Usunięty użytkownik można przywrócić, ustawiając stan użytkownika na aktywny. Nie trzeba ponownie wypełniać pozostałych pól w zasobie użytkownika. Te wartości zostaną automatycznie przywrócone z usuniętego, nieaktywnego zasobu użytkownika. Następnie użyj metody IAggregatePartner.Customers.ById z identyfikatorem klienta, aby zidentyfikować klienta, oraz metodę Users.ById, aby zidentyfikować użytkownika.

Na koniec wywołaj metodę Patch i przekaż wystąpienie CustomerUser , aby wysłać żądanie przywrócenia użytkownika.

// 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);

Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: CustomerUserRestore.cs

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
PATCH {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Parametr identyfikatora URI

Użyj następujących parametrów zapytania, aby określić identyfikator klienta i identyfikator użytkownika.

Imię i nazwisko/nazwa Type Wymagana Opis
identyfikator dzierżawy klienta Identyfikator guid Y Wartość jest identyfikatorem GUID sformatowanym identyfikatorem customer-tenant-id , który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta.
identyfikator użytkownika Identyfikator guid Y Wartość jest identyfikatorem GUID sformatowanym przez użytkownika , który należy do jednego konta użytkownika.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

W tej tabeli opisano wymagane właściwości w treści żądania.

Imię i nazwisko/nazwa Type Wymagana Opis
State string Y Stan użytkownika. Aby przywrócić usuniętego użytkownika, ten ciąg musi zawierać ciąg "aktywny".
Atrybuty obiekt N Zawiera wartość "ObjectType": "CustomerUser".

Przykład żądania

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"
    }
}

Odpowiedź REST

W przypadku powodzenia odpowiedź zwraca przywrócone informacje o użytkowniku w treści odpowiedzi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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"
    }
}