Obnovení odstraněného uživatele pro zákazníka

  • Článek

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