Získání seznamu dávek zařízení pro konkrétního zákazníka

Článek
10/15/2024

Platí pro: Partnerské centrum

Jak načíst kolekci dávek zařízení pro zadaného zákazníka

Každá dávka zařízení obsahuje souhrnné informace o stavu zařízení zaregistrovaných v nasazení s nulovým dotykem.

Příslušné role: Agent pro správu | Prodejní agent

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i 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).

C#

Pokud chcete získat kolekci dávek zařízení pro zadaného zákazníka, nejprve zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka a načtěte rozhraní pro operace se zadaným zákazníkem. Pak načtěte hodnotu DeviceBatches vlastnost získat rozhraní pro operace dávkového shromažďování zařízení. Nakonec zavolejte metodu Get nebo GetAsync, která načte kolekci.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var devicesBatches =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Get();

Ukázka: Konzolová testovací aplikace Projekt: Třída ukázek sady SDK Partnerského centra: GetDevicesBatches.cs

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

Parametr identifikátoru URI

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

Name	Type	Požadováno	Popis
ID zákazníka	string	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.

Záhlaví žádosti

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

Text požadavku

Nic

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi kolekci prostředků DeviceBatch .

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: 339
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "Test batch",
            "status": "finished",
            "creationDate": "2017-07-25T01:51:00",
            "devicesCount": 5,
            "devicesLink": {
                "uri": "/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/Test batch/devices",
                "method": "GET",
                "headers": []
            },
            "attributes": {
                "objectType": "DeviceBatch"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Sdílet prostřednictvím