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"
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla