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

Článek
09/11/2024

Platí pro: Partnerské centrum

Tento článek popisuje, jak načíst kolekci zařízení v zadané dávce zařízení pro zadaného zákazníka. Každý prostředek zařízení obsahuje podrobnosti o zařízení.

Požadavky

Přihlašovací údaje, jak je popsáno v tématu 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 ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte ID Microsoft v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Identifikátor dávky zařízení.

C#

Načtení kolekce zařízení v zadané dávce zařízení pro zadaného zákazníka:

Zavoláním metody IAggregatePartner.Customers.ById s ID zákazníka načtěte rozhraní pro operace u zadaného zákazníka.
Voláním metody DeviceBatches.ById získáte rozhraní pro operace shromažďování dávek zařízení pro zadanou dávku.
Načtením vlastnosti Devices získáte rozhraní pro operace shromažďování zařízení pro dávku.
Voláním metody Get nebo GetAsync načtěte kolekci zařízení.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

var devices =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.Get();

Příklad:

Ukázka: Testovací aplikace konzoly
Projekt: Ukázky sady SDK Partnerského centra
Třída: GetDevices.cs

Požadavek REST

Syntaxe požadavku

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

Parametry identifikátoru URI

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

Název	Typ	Vyžadováno	Popis
ID zákazníka	řetězec	Yes	Řetězec ve formátu GUID, který identifikuje zákazníka.
devicebatch-id	řetězec	Yes	Identifikátor řetězce, který identifikuje dávku zařízení.

Hlavičky požadavku

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

Text požadavku

Žádné

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/testbatch/devices 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 text odpovědi stránkovanou kolekci prostředků zařízení . Kolekce obsahuje na stránce 100 zařízení. Pokud chcete načíst další stránku 100 zařízení, musí být do následného požadavku zahrnutý token continuationToken v textu odpovědi jako hlavička MS-ContinuationToken.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, 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 ROZHRANÍ REST v Partnerském centru.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 1742
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": 2,
    "items":
    [{
            "id": "7c141ea9-2816-4e15-a819-53f6856499ff",
            "serialNumber": "2R9-ZNP67",
            "productKey": "00329-00000-0003-AA6069",
            "modelName": "Precision WorkStation T7500",
            "oemManufacturerName":"Dell Inc.",
            "policies":[{
                    "key": "o_o_b_e",
                    "value": null
                }
            ],
            "uploadedDate":"2017-08-09T14:43:26.0092288-07:00",
            " attributes": {
                "objectType": "Device"
            }
        }, {
            "id": "e528a62f-5031-49f4-bea7-5fafe47388fd",
            "serialNumber": "1234567890",
            "productKey": "12345-67890-09876-54321-13579",
            "modelName": "HP Z420 Workstation",
            "oemManufacturerName": "Hewlett-Packard",
            "policies": [{
                    "key": "o_o_b_e",
                    "value": null
                }
            ],
            "uploadedDate": "2017-08-09T14:35:51.3126144-07:00",
            "attributes": {
                "objectType": "Device"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Sdílet prostřednictvím