Freigeben über

Produkteinreichungen verwalten

  • Artikel

Verwenden Sie die folgenden Methoden in Microsoft Hardware-APIs, um Einreichungen für Ihre Produkte zu verwalten und sie von Microsoft signieren zu lassen. Eine Einführung in Microsoft Hardware-APIs, einschließlich der Voraussetzungen für die Verwendung der API, finden Sie unter Hardware Dashboard-API.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Methoden zur Verwaltung von Produkteinreichungen

Method URI Beschreibung
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Status/Daten für ein bestimmtes Produkt abrufen
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Status/Daten für eine bestimmte Einreichung eines Produkts abrufen
NACHRICHT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Neues Produkt erstellen
NACHRICHT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Erstellen einer neuen Einreichung für ein Produkt
NACHRICHT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Einreichen eines Produkts committen

Erstellen und Einreichung eines Produkts zum Signieren

  1. Falls Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Hardware-APIs.

  2. Erhalten eines Microsoft Entra ID-Zugriffstokens. Sie müssen dieses Zugriffstoken an die Methoden in der Microsoft Store-Übermittlungs-API übergeben. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

  3. Erstellen Sie ein neues Produkt, indem Sie die folgende Methode in der Microsoft Hardware-API ausführen. Dadurch wird ein neues, in Bearbeitung befindliches Produkt erstellt und Ihnen die Möglichkeit geboten, Packages für dieses Produkt zu senden.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

    Der Antwort-Body enthält eine Product-Ressource, die die ID dieses Produkts enthält.

  4. Erstellen Sie eine Einreichung für dieses Produkt, indem Sie die folgende Methode in der Microsoft Hardware-API ausführen. Verwenden Sie die im obigen Schritt erstellte ProductID.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/

    Der Antwort-Body enthält eine Submission-Ressource, die die ID der Einreichung, die gemeinsame Zugriffssignatur (SAS) URI für das Hochladen des Produkt-(Treiber-)Pakets für die Einreichung in Azure Blob Storage enthält. [HINWEIS] > Eine SAS-URI ermöglicht den Zugriff auf eine sichere Ressource im Azure Storage, ohne dass Kontoschlüssel erforderlich sind. Hintergrundinformationen zu SAS-URIs und deren Verwendung mit Azure Blob Storage finden Sie unter Shared Access Signatures, Teil 1: Grundlegendes zum SAS-Modell und freigegebenen Zugriffssignaturen, Teil 2: Erstellen und Verwenden eines SAS mit Blob-Speicher.

  5. Laden Sie Ihr Paket in den Azure Blob Storage an dem Ort hoch, der durch den SAS-URI im vorherigen Schritt angegeben wurde. Das folgende C# Code-Beispiel zeigt, wie Sie ein Paket mit Hilfe der Klasse CloudBlockBlob in der Azure Storage Client Library für .NET in den Azure Blob Storage hochladen. In diesem Beispiel wird davon ausgegangen, dass das Paket bereits in ein Stream-Objekt geschrieben wurde.

    string sasUrl = "<SAS URL from Hardware API>";
Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
    new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
await blockBob.UploadFromStreamAsync(stream);

  6. Bestätigen Sie die Produkteinrichtung, indem Sie die folgende Methode ausführen. Dadurch wird das Hardware Dev Center informiert, dass Sie Ihre Produkteinreichung abgeschlossen haben und die Validierung für die Einreichung wird gestartet.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit

  7. Sie können den Status der Einreichung überprüfen, indem Sie die folgende Methode ausführen, um den Status der Produkteinreichung abzufragen.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}

    Um den Einreichungsstatus zu bestätigen, überprüfen Sie den Wert commitStatus im Antwort-Body. Dieser Wert sollte sich von CommitReceived auf CommitComplete ändern, wenn die Anfrage erfolgreich war, oder auf CommitFailed, wenn die Anfrage Fehler enthält.

    Hinweis

    Die Hauptseite der Suche wird etwa alle 10 Minuten aktualisiert. Wenn Sie alle Ergebnisse nach und nach anzeigen möchten, klicken Sie auf Liste der Treiber (alle), oben auf der Seite Treiber im Partner Center. Obwohl die Seite einige Zeit braucht, um zu verarbeiten und zu laden, wenn Sie viele Einträge haben, sollten sowohl erfolgreiche als auch erfolglose Einreichungen aufgelistet werden, wenn sie geladen ist. Weitere Informationen finden Sie unter Suchen einer Hardwareeinreichung.

Codebeispiele

Die folgenden Code-Beispiele zeigen Ihnen, wie Sie die Microsoft Hardware-API verwenden können:

Datenressourcen

Die Methoden der Microsoft Hardware-APIs zur Erstellung und Verwaltung von Produktdaten verwenden die folgenden JSON-Datenressourcen:

Weitere Informationen