Ladda upp en lista över enheter för att skapa en ny batch för den angivna kunden

Artikel
03/04/2024

Gäller för: Partnercenter

Så här laddar du upp en lista med information om enheter för att skapa en ny batch för den angivna kunden. Detta skapar en enhetsbatch för registrering i zero-touch-distribution och associerar enheterna och enhetsbatchen med den angivna kunden.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med app+användarautentiseringsuppgifter. Följ den säkra appmodellen när du använder App+User-autentisering med Partnercenter-API:er.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Listan över enhetsresurser som innehåller information om de enskilda enheterna.

C#

Så här laddar du upp en lista över enheter för att skapa en ny enhetsbatch:

Instansiera en ny [List/dotnet/api/system.collections.generic.list-1) av typen Enhet och fyll i listan med enheterna. Följande kombinationer av ifyllda egenskaper krävs minst för att identifiera varje enhet:
- HardwareHash + ProductKey.
- HardwareHash + SerialNumber.
- HardwareHash + ProductKey + SerialNumber.
- Endast HardwareHash .
- Endast ProductKey .
- SerialNumber + OemManufacturerName + ModelName.
Instansiera ett DeviceBatchCreationRequest-objekt och ange egenskapen BatchId till ett unikt namn som du väljer och egenskapen Enheter till listan över enheter som ska laddas upp.
Bearbeta begäran om att skapa enhetsbatch genom att anropa metoden IAggregatePartner.Customers.ById med kundidentifieraren för att hämta ett gränssnitt till åtgärder på den angivna kunden.
Anropa metoden DeviceBatches.Create eller CreateAsync med begäran om att skapa batchen för enheten.

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

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: CreateDeviceBatch.cs

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

URI-parameter

Använd följande sökvägsparametrar när du skapar begäran.

Namn	Typ	Obligatoriskt	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Begärandetexten måste innehålla en DeviceBatchCreationRequest-resurs .

Exempel på begäran

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

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas innehåller svaret ett platshuvud som har en URI som kan användas för att hämta enhetens uppladdningsstatus. Spara den här URI:n för användning med andra relaterade REST-API:er.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

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

Dela via