Ottenere un elenco dei dispositivi per il batch e il cliente specificati

Articolo
09/11/2024

Si applica a: Centro per i partner

Questo articolo descrive come recuperare una raccolta di dispositivi in un batch di dispositivi specificato per un cliente specificato. Ogni risorsa del dispositivo contiene dettagli sul dispositivo.

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 cliente (customer-tenant-id).
Identificatore batch del dispositivo.

C#

Per recuperare una raccolta dei dispositivi in un batch di dispositivi specificato per il cliente specificato:

Chiamare il metodo IAggregatePartner.Customers.ById con l'ID cliente per recuperare un'interfaccia per le operazioni sul cliente specificato.
Chiamare il metodo DeviceBatches.ById per ottenere un'interfaccia per le operazioni di raccolta batch del dispositivo per il batch specificato.
Recuperare la proprietà Devices per ottenere un'interfaccia per le operazioni di raccolta dei dispositivi per il batch.
Chiamare il metodo Get o GetAsync per recuperare la raccolta di dispositivi.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

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

Per un esempio, vedere quanto segue:

Esempio: App di test della console
Progetto: Esempi di SDK del Centro per i partner
Classe: GetDevices.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

Parametri URI

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

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.
devicebatch-id	string	Sì	Identificatore di stringa che identifica il batch del dispositivo.

Intestazioni della richiesta

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

Testo della richiesta

Nessuno

Esempio di richiesta

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

Risposta REST

Se ha esito positivo, il corpo della risposta contiene una raccolta paginata di risorse dispositivo . La raccolta contiene 100 dispositivi in una pagina. Per recuperare la pagina successiva di 100 dispositivi, la continuazioneToken nel corpo della risposta deve essere inclusa nella richiesta successiva come intestazione MS-ContinuationToken.

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 un elenco completo, vedere Codici di errore REST del Centro per i partner.

Esempio di risposta

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

Condividi tramite