Caricare un elenco di dispositivi in un batch esistente per il cliente specificato

Articolo
03/02/2024

Si applica a: Centro per i partner

Come caricare un elenco di informazioni sui dispositivi in un batch esistente per il cliente specificato. In questo modo i dispositivi vengono associati a un batch di dispositivi già creato.

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 Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Identificatore batch del dispositivo.
Elenco di risorse del dispositivo che forniscono le informazioni sui singoli dispositivi.

C#

Per caricare un elenco di dispositivi in un batch di dispositivi esistente, creare prima un'istanza di un nuovo [List/dotnet/api/system.collections.generic.list-1) di tipo Dispositivo e popolare l'elenco con i dispositivi. Per identificare ogni dispositivo sono necessarie almeno le combinazioni di proprietà popolate:

HardwareHash + ProductKey.
HardwareHash + SerialNumber.
HardwareHash + ProductKey + SerialNumber.
Solo HardwareHash .
Solo ProductKey .
SerialNumber + OemManufacturerName ModelName. +

Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente per recuperare un'interfaccia alle operazioni sul cliente specificato. Chiamare quindi il metodo DeviceBatches.ById con l'identificatore batch del dispositivo per ottenere un'interfaccia alle operazioni per il batch specificato. Chiamare infine il metodo Devices.Create o CreateAsync con l'elenco dei dispositivi per aggiungere i dispositivi al batch del dispositivo.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

List<Device> devicesToBeUploaded = new List<Device>
{
    new Device
    {
        HardwareHash = "DummyHash1234",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    },

    new Device
    {
        HardwareHash = "DummyHash12345",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    }
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.Create(devicesToBeUploaded);

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

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

Parametro URI

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

Nome	Digita	Obbligatorio	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 delle richieste

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

Corpo della richiesta

Il corpo della richiesta deve contenere una matrice di oggetti Device . Vengono accettate le seguenti combinazioni di campi per l'identificazione di un dispositivo:

hardwareHash + productKey.
hardwareHash + serialNumber.
hardwareHash + productKey + serialNumber.
solo hardwareHash.
solo productKey.
serialNumber + oemManufacturerName + modelName.

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches/Test/devices HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 482
Expect: 100-continue

[{
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash1234",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }, {
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash12345",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }
]

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner.

Risposta REST

In caso di esito positivo, la risposta contiene un'intestazione Location con un URI che può essere usato per recuperare lo stato di caricamento del dispositivo. Salvare questo URI per l'uso con altre API REST correlate.

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 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/16c00110-e79a-433d-aa28-f69dd60df671
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CV: OBkGN9pSN0a5xvua.0
MS-ServerId: 101112012
Date: Thu, 28 Sep 2017 20:08:46 GMT

Condividi tramite