Hochladen einer Liste von Geräten zu einem vorhandenen Batch für den angegebenen Kunden

  • Artikel

Gilt für: Partner Center

So laden Sie eine Liste von Informationen zu Geräten in einen vorhandenen Batch für den angegebenen Kunden hoch. Dadurch werden die Geräte einem bereits erstellten Gerätebatch zugeordnet.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

  • 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).

  • Der Gerätebatchbezeichner.

  • Die Liste der Geräteressourcen, die die Informationen zu den einzelnen Geräten bereitstellen.

C#

Um eine Liste von Geräten in einen vorhandenen Gerätebatch hochzuladen, instanziieren Sie zunächst 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:

Rufen Sie dann die IAggregatePartner.Customers.ById-Methode mit dem Kundenbezeichner auf, um eine Schnittstelle zu Vorgängen für den angegebenen Kunden abzurufen. Rufen Sie als Nächstes die DeviceBatches.ById-Methode mit dem Gerätebatchbezeichner auf, um eine Schnittstelle zu Vorgängen für den angegebenen Batch abzurufen. Rufen Sie schließlich die Methode "Devices.Create" oder "CreateAsync" mit der Liste der Geräte auf, um die Geräte zum Gerätebatch hinzuzufügen.

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

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

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie beim Erstellen der Anforderung die folgenden Pfad- und Abfrageparameter.

Name Type Erforderlich Beschreibung
Kunden-ID Zeichenfolge Ja Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
devicebatch-id Zeichenfolge Ja Ein Zeichenfolgenbezeichner, der den Gerätebatch identifiziert.

Anforderungsheader

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

Anforderungstext

Der Anforderungstext muss ein Array von Device-Objekten enthalten. Die folgenden Kombinationen von Feldern zum Identifizieren eines Geräts werden akzeptiert:

  • hardwareHash + productKey.
  • hardwareHash + serialNumber.
  • hardwareHash + productKey + serialNumber.
  • nur hardwareHash.
  • nur productKey.
  • serialNumber + oemManufacturerName + modelName.

Beispiel für eine Anfrage

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

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/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