Zobrazení odstraněných uživatelů pro zákazníka

  • Článek

Získá seznam odstraněných prostředků CustomerUser pro zákazníka podle ID zákazníka. Volitelně můžete nastavit velikost stránky. Musíte zadat filtr.

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

Co se stane, když odstraníte uživatelský účet?

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. Pokud chcete obnovit odstraněný uživatelský účet v rámci 30denního okna, přečtěte si téma Obnovení odstraněného uživatele pro zákazníka. Po odstranění a označení "neaktivní" se už uživatelský účet nevrátí jako člen kolekce uživatelů (například pomocí funkce Získat seznam všech uživatelských účtů pro zákazníka). Pokud chcete získat seznam odstraněných uživatelů, kteří ještě nebyli vymazáni, musíte zadat dotaz na uživatelské účty, které byly nastaveny na neaktivní.

C#

Pokud chcete načíst seznam odstraněných uživatelů, vytvořte dotaz, který vyfiltruje uživatele zákazníka, jejichž stav je nastavený na neaktivní. Nejprve vytvořte filtr vytvořením instance SimpleFieldFilter objektu s parametry, jak je znázorněno v následujícím fragmentu kódu. Pak vytvořte dotaz pomocí BuildIndexedQuery metoda. Pokud nechcete stránkovat výsledky, můžete místo toho použít metodu BuildSimpleQuery . Dále pomocí metody IAggregatePartner.Customers.ById s ID zákazníka identifikujte zákazníka. Nakonec voláním metody Query odešlete požadavek.

// IAggregatePartner partnerOperations;
// int customerUserPageSize;

// Create a filter for users whose status is inactive (i.e. deleted).
var filter = new SimpleFieldFilter("UserState", FieldFilterOperation.Equals, "Inactive");

// Build a paged query.
var simpleQueryWithFilter = QueryFactory.Instance.BuildIndexedQuery(customerUserPageSize, 0, filter);

// Send the request.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.Query(simpleQueryWithFilter);

Ukázka: Konzolová testovací aplikace Projekt: Ukázky sady SDK v Partnerském centru – třída: GetCustomerInactiveUsers.cs

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-id}/users?size={size}&filter={filter} HTTP/1.1

Parametr identifikátoru URI

Při vytváření požadavku použijte následující cestu a parametry dotazu.

Name Type Požadováno Popis
ID zákazníka guid Ano Hodnota je GUID formátované ID zákazníka, které identifikuje zákazníka.
size int No Počet výsledků, které se mají zobrazit najednou. Tento parametr je volitelný.
filter filter Ano Dotaz, který filtruje vyhledávání uživatelů. Pokud chcete načíst odstraněné uživatele, musíte zahrnout a zakódovat následující řetězec: {"Field":"UserState","Value":"Inactive","Operator":"equals"}.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users?size=500&filter=%7B%22Field%22%3A%22UserState%22%2C%22Value%22%3A%22Inactive%22%2C%22Operator%22%3A%22equals%22%7D HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c11feb95-55d2-45b6-9d1b-74b55d2221fb
MS-CorrelationId: 2b4ab588-f48c-4874-b479-a61895e107b2
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Odpověď REST

V případě úspěchu vrátí tato metoda kolekci prostředků CustomerUser v těle 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 v Partnerském centru.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 802
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 690b34ca-07c8-4f8a-ab13-f22a50594a43
MS-RequestId: 1187f9ad-02b4-4d96-b668-7cf3d289467b
MS-CV: 3TLmR9gz6EaCVCjR.0
MS-ServerId: 101112616
Date: Fri, 20 Jan 2017 19:13:14 GMT

{
    "totalCount": 1,
    "items": [{
            "usageLocation": "US",
            "id": "a45f1416-3300-4f65-9e8d-f123b397a4ea",
            "userPrincipalName": "e83763f7f2204ac384cfcd49f79f2749@dtdemocspcustomer005.onmicrosoft.com",
            "firstName": "Ferdinand",
            "lastName": "Filibuster",
            "displayName": "Ferdinand",
            "userDomainType": "none",
            "state": "inactive",
            "softDeletionTime": "2017-01-20T00:33:34Z",
            "links": {
                "self": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "CustomerUser"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users?size=500&filter=%7B%22Field%22%3A%22UserStatus%22%2C%22Value%22%3A%22Inactive%22%2C%22Operator%22%3A%22equals%22%7D",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}