Obnovení odstraněného uživatele pro zákazníka
Obnovení odstraněného uživatele podle ID zákazníka a ID uživatele
Požadavky
Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
ID zákazníka (
customer-tenant-id
). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id
).ID uživatele. Pokud nemáte ID uživatele, přečtěte si téma Zobrazení odstraněných uživatelů pro zákazníka.
Role GDAP
Budete potřebovat alespoň jednu z následujících rolí GDAP:
- Správce uživatelů
- Zapisovač adresářů
Obnovení odstraněného uživatelského účtu
Stav uživatele je při odstranění uživatelského účtu nastavený na neaktivní. Zůstane to tak po dobu 30 dnů, po které se uživatelský účet a jeho přidružená data vymažou a neupraví se. Během tohoto 30denního okna můžete obnovit jenom odstraněný uživatelský účet. Po odstranění a označení neaktivního uživatelského účtu se už nebude vracet jako člen kolekce uživatelů (například pomocí získání seznamu všech uživatelských účtů pro zákazníka).
C#
Chcete-li obnovit uživatele, vytvořte novou instanci Třídy CustomerUser a nastavte hodnotu User.State vlastnost UserState.Active.
Odstraněného uživatele obnovíte nastavením stavu uživatele na aktivní. Zbývající pole v uživatelském prostředku nemusíte znovu naplnit. Tyto hodnoty se automaticky obnoví z odstraněného neaktivního prostředku uživatele. Dále použijte metodu IAggregatePartner.Customers.ById s ID zákazníka k identifikaci zákazníka a metodu Users.ById k identifikaci uživatele.
Nakonec zavolejte metodu Patch a předejte instanci CustomerUser k odeslání požadavku na obnovení uživatele.
// 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);
Ukázka: Konzolová testovací aplikace Projekt: Ukázky sady SDK Partnerského centra – třída: CustomerUserRestore.cs
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI žádosti |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1 |
Parametr identifikátoru URI
Pomocí následujících parametrů dotazu zadejte ID zákazníka a ID uživatele.
Jméno | Typ | Požadováno | Popis |
---|---|---|---|
customer-tenant-id | Identifikátor guid | Y | Hodnota je IDENTIFIKÁTOR GUID formátovaný id tenanta zákazníka, který umožňuje prodejci filtrovat výsledky pro daného zákazníka. |
ID uživatele | Identifikátor guid | Y | Hodnota je IDENTIFIKÁTOR GUID formátovaný id uživatele , které patří do jednoho uživatelského účtu. |
Záhlaví žádosti
Další informace najdete v tématu Hlavičky REST Partnerského centra.
Text požadavku
Tato tabulka popisuje požadované vlastnosti v textu požadavku.
Jméno | Typ | Požadováno | Popis |
---|---|---|---|
Stát | řetězec | Y | Stav uživatele. Chcete-li obnovit odstraněného uživatele, musí tento řetězec obsahovat "aktivní". |
Atributy | objekt | N | Obsahuje "ObjectType": "CustomerUser". |
Příklad požadavku
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"
}
}
Odpověď REST
V případě úspěchu vrátí odpověď obnovené informace o uživateli v textu odpovědi.
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST Partnerského centra.
Příklad odpovědi
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"
}
}
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro