Caricare un elenco di dispositivi per creare un nuovo batch per il cliente specificato

Articolo
03/04/2024

Si applica a: Centro per i partner

Come caricare un elenco di informazioni sui dispositivi per creare un nuovo batch per il cliente specificato. In questo modo viene creato un batch di dispositivi per la registrazione nella distribuzione zero-touch e vengono associati i dispositivi e il batch di dispositivi al cliente specificato.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali dell'app e dell'utente. Seguire il modello di app sicura quando si usa l'autenticazione app+utente con le API del Centro per i partner.
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).
Elenco di risorse del dispositivo che forniscono le informazioni sui singoli dispositivi.

C#

Per caricare un elenco di dispositivi per creare un nuovo batch di dispositivi:

Creare un'istanza di un nuovo [List/dotnet/api/system.collections.generic.list-1) di tipo Device 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. +
Creare un'istanza di un oggetto DeviceBatchCreationRequest e impostare la proprietà BatchId su un nome univoco di propria scelta e la proprietà Devices sull'elenco dei dispositivi da caricare.
Elaborare la richiesta di creazione batch del dispositivo chiamando il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente per recuperare un'interfaccia per le operazioni sul cliente specificato.
Chiamare il metodo DeviceBatches.Create o CreateAsync con la richiesta di creazione batch del dispositivo per creare il batch.

IAggregatePartner partnerOperations;
string selectedCustomerId;

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

DeviceBatchCreationRequest
    newDeviceBatch = new DeviceBatchCreationRequest
{
    BatchId = "SDKTestDeviceBatch",
    Devices = devicesToBeUploaded
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Create(newDeviceBatch);

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

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches 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.

Intestazioni delle richieste

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

Corpo della richiesta

Il corpo della richiesta deve contenere una risorsa DeviceBatchCreationRequest .

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: e3f26e6a-044f-4371-ad52-0d91ce4200be
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
    "BatchId": "SDKTestDeviceBatch",
    "Devices": [{
            "Id": null,
            "SerialNumber": "1R9-ZNP67",
            "ProductKey": "00329-00000-0003-AA606",
            "HardwareHash": "DummyHash123",
            "Policies": null,
            "CreatedBy": null,
            "UploadedDate": "0001-01-01T00:00:00",
            "AllowedOperations": null,
            "Attributes": {
                "ObjectType": "Device"
            }
        }
    ],
    "Attributes": {
        "ObjectType": "DeviceBatchCreationRequest"
    }
}

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/beba2053-5401-46ff-9223-7e841ed78fbf
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2017 20:35:35 GMT

Condividi tramite