Získání stavu nahrání dávek zařízení

Článek
08/02/2023

Platí pro: Partnerské centrum

Jak získat stav dávkového nahrávání zařízení pro konkrétního zákazníka

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

Předpoklady

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).
Identifikátor dávkového sledování vrácený v hlavičce Umístění při odeslání dávky zařízení. Další informace najdete v tématu Nahrání seznamu zařízení pro zadaného zákazníka.

C#

Pokud chcete získat stav dávkového nahrávání zařízení, nejprve zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka a načtěte rozhraní pro operace se zadaným zákazníkem. Potom zavolejte metodu BatchUploadStatus.ById s ID dávkového sledování, abyste získali rozhraní pro operace stavu dávkového nahrání. Nakonec zavolejte metodu Get nebo GetAsync, která načte stav.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedTrackingId;

var status =
    partnerOperations.Customers.ById(selectedCustomerId).BatchUploadStatus.ById(selectedTrackingId).Get();

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

Požadavek REST

Syntaxe požadavku

Způsob	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-id}/batchJobStatus/{batchtracking-id} HTTP/1.1

Parametr identifikátoru URI

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

Jméno	Typ	Požadováno	Popis
ID zákazníka	řetězec	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.
batchtracking-id	řetězec	Ano	Identifikátor ve formátu GUID, který se používá k načtení stavu dávkového nahrání zařízení. Toto ID se vrátí v hlavičce Umístění, když se dávka zařízení úspěšně odešle.

Záhlaví žádosti

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/batchjobstatus/0127ed8e-ff72-4983-a3d8-e8d8bd378932 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Odpověď REST

V případě úspěchu odpověď obsahuje prostředek BatchUploadDetails .

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: 400
MS-CorrelationId: 4a5002a2-0c1b-4e57-b491-dbcf19c0e7b8
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT

{
    "batchTrackingId": "0127ed8e-ff72-4983-a3d8-e8d8bd378932",
    "status": "finished",
    "startedTime": "2017-07-25T10:00:00",
    "completedTime": "2017-07-25T10:10:00",
    "devicesStatus": [{
            "serialNumber": "1234567890",
            "productKey": "12345-67890-09876-54321-13579",
            "status": "finished_with_errors",
            "errorCode": "808",
            "errorDescription": "ZtdDeviceAssignedToOtherTenant",
            "attributes": {
                "objectType": "DeviceUploadDetails"
            }
        }
    ],
    "attributes": {
        "objectType": "BatchUploadDetails"
    }
}

Sdílet prostřednictvím