Een lijst met apparaten uploaden naar een bestaande batch voor de opgegeven klant

Artikel
09/11/2024

Van toepassing op: Partnercentrum

Een lijst met informatie over apparaten uploaden naar een bestaande batch voor de opgegeven klant. Hiermee worden de apparaten gekoppeld aan een apparaatbatch die al is gemaakt.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De batch-id van het apparaat.
De lijst met apparaatbronnen die de informatie over de afzonderlijke apparaten verstrekken.

C#

Als u een lijst met apparaten wilt uploaden naar een bestaande apparaatbatch, instantieert u eerst een nieuwe [List/dotnet/api/system.collections.generic.list-1) van het type Apparaat en vult u de lijst met de apparaten in. De volgende combinaties van ingevulde eigenschappen zijn minimaal vereist voor het identificeren van elk apparaat:

HardwareHash + ProductKey.
HardwareHash + SerialNumber.
HardwareHash + ProductKey + SerialNumber.
Alleen HardwareHash .
Alleen ProductKey .
SerialNumber + OemManufacturerName ModelName. +

Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant. Roep vervolgens de methode DeviceBatches.ById aan met de batch-id van het apparaat om een interface op te halen voor bewerkingen voor de opgegeven batch. Roep tot slot de methode Devices.Create of CreateAsync aan met de lijst met apparaten om de apparaten toe te voegen aan de apparaatbatch.

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);

Voorbeeld: consoletest-app. Project: Voorbeeldklasse partnercentrum-SDK: CreateDevices.cs

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

URI-parameter

Gebruik het volgende pad en queryparameters bij het maken van de aanvraag.

Name	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks met GUID-indeling die de klant identificeert.
devicebatch-id	tekenreeks	Ja	Een tekenreeks-id die de apparaatbatch identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

De hoofdtekst van de aanvraag moet een matrix van apparaatobjecten bevatten. De volgende combinaties van velden voor het identificeren van een apparaat worden geaccepteerd:

hardwareHash + productKey.
hardwareHash + serialNumber.
hardwareHash + productKey + serialNumber.
alleen hardwareHash.
alleen productKey.
serialNumber + oemManufacturerName + modelName.

Aanvraagvoorbeeld

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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
        }
    }
]

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

REST-antwoord

Als dit lukt, bevat het antwoord een locatieheader met een URI die kan worden gebruikt om de uploadstatus van het apparaat op te halen. Sla deze URI op voor gebruik met andere gerelateerde REST API's.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/16c00110-e79a-433d-aa28-f69dd60df671
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CV: OBkGN9pSN0a5xvua.0
MS-ServerId: 101112012
Date: Thu, 28 Sep 2017 20:08:46 GMT

Delen via