Hochladen einer Liste von Geräten zum Erstellen eines neuen Batches für den angegebenen Kunden

Artikel
03/04/2024

Gilt für: Partner Center

So laden Sie eine Liste von Informationen zu Geräten hoch, um einen neuen Batch für den angegebenen Kunden zu erstellen. Dadurch wird ein Gerätebatch für die Registrierung bei der Zero-Touch-Bereitstellung erstellt und die Geräte und der Gerätebatch dem angegebenen Kunden zugeordnet.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird die Authentifizierung mit App- und Benutzeranmeldeinformationen unterstützt. Folgen Sie dem sicheren App-Modell bei Verwendung der App+Benutzerauthentifizierung mit Partner Center-APIs.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Die Liste der Geräteressourcen, die die Informationen zu den einzelnen Geräten bereitstellen.

C#

So laden Sie eine Liste von Geräten hoch, um einen neuen Gerätebatch zu erstellen:

Instanziieren Sie eine neue [List/dotnet/api/system.collections.generic.list-1) vom Typ "Gerät ", und füllen Sie die Liste mit den Geräten auf. Die folgenden Kombinationen von ausgefüllten Eigenschaften sind mindestens erforderlich, um jedes Gerät zu identifizieren:
- HardwareHash + ProductKey.
- HardwareHash + SerialNumber.
- HardwareHash + ProductKey + SerialNumber.
- Nur HardwareHash .
- Nur ProductKey .
- SerialNumber + OemManufacturerName + ModelName.
Instanziieren Sie ein DeviceBatchCreationRequest-Objekt, und legen Sie die BatchId-Eigenschaft auf einen eindeutigen Namen Ihrer Wahl fest, und die Geräteeigenschaft auf die Liste der hochzuladenden Geräte.
Verarbeiten Sie die Anforderung zum Erstellen des Gerätebatches, indem Sie die IAggregatePartner.Customers.ById-Methode mit dem Kundenbezeichner aufrufen, um eine Schnittstelle zu Vorgängen für den angegebenen Kunden abzurufen.
Rufen Sie die Methode DeviceBatches.Create oder CreateAsync mit der Anforderung zum Erstellen des Batches auf, um den Batch zu erstellen.

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

Beispiel: Konsolentest-App. Projekt: Partner Center SDK Samples Class: CreateDeviceBatch.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

URI-Parameter

Verwenden Sie beim Erstellen der Anforderung die folgenden Pfadparameter.

Name	Type	Erforderlich	Beschreibung
Kunden-ID	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Der Anforderungstext muss eine DeviceBatchCreationRequest-Ressource enthalten.

Beispiel für eine Anfrage

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

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

REST-Antwort

Wenn die Antwort erfolgreich verläuft, enthält die Antwort einen Location-Header mit einem URI, der zum Abrufen des Geräteuploadstatus verwendet werden kann. Speichern Sie diesen URI für die Verwendung mit anderen verwandten REST-APIs.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

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

Share via