Ottenere lo stato di un caricamento batch di dispositivi

Articolo
10/15/2024

Si applica a: Centro per i partner

Come ottenere lo stato di un caricamento batch di dispositivi per un cliente specificato.

Ruoli appropriati: Agente amministratore | Agente di vendita

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Identificatore di rilevamento batch restituito nell'intestazione Location quando è stato inviato il batch del dispositivo. Per altre informazioni, vedere Caricare un elenco di dispositivi per il cliente specificato.

C#

Per ottenere lo stato di un caricamento batch del dispositivo, chiamare prima di tutto il metodo IAggregatePartner.Customers.ById con l'ID cliente per recuperare un'interfaccia per le operazioni sul cliente specificato. Chiamare quindi il metodo BatchUploadStatus.ById con l'ID di rilevamento batch per ottenere un'interfaccia per eseguire operazioni di stato di caricamento batch. Infine, chiamare il metodo Get o GetAsync per recuperare lo stato.

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

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

Esempio: App di test della console. Project: Partner Center SDK Samples Class: GetBatchUploadStatus.cs

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-id}/batchJobStatus/{batchtracking-id} HTTP/1.1

Parametro URI

Usare i parametri di percorso seguenti durante la creazione della richiesta.

Nome	Digita	Obbligatorio	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.
batchtracking-id	string	Sì	Identificatore in formato GUID usato per recuperare lo stato di caricamento batch del dispositivo. Questo ID viene restituito nell'intestazione Location quando il batch del dispositivo viene inviato correttamente.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

None

Esempio di richiesta

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Risposta REST

In caso di esito positivo, la risposta contiene una risorsa BatchUploadDetails .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

HTTP/1.1 200 OK
Content-Length: 400
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

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

Condividi tramite