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 Hardwaredashboard-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
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Neues Produkt erstellen
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Erstellen einer neuen Einreichung für ein Produkt
POST 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. 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. Durch diese Methode 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 vorherigen 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 zu ihrer Verwendung mit Azure Blob Storage finden Sie unter Gewähren des eingeschränkten Zugriffs auf Azure Storage-Ressourcen mithilfe von SAS (Shared Access Signatures).

  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 BlockBlobClient in der Azure Storage Blobs 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>";
Azure.Storage.Blobs.Specialized.BlockBlobClient blockBlobClient =
    new Azure.Storage.Blobs.Specialized.BlockBlobClient(new System.Uri(sasUrl));
string filePath = "<Path to HLK package>";
using (FileStream fileStream = File.OpenRead(filePath))
{ 
    await blockBlobClient.UploadAsync(fileStream);
}

  6. Bestätigen Sie die Produkteinrichtung, indem Sie die folgende Methode ausführen. Diese Methode benachrichtigt das Hardware Dev Center, dass Sie mit der Übermittlung Ihres Produkts fertig sind, und die Validierung für die Übermittlung beginnt.

    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.

Codebeispiel

Das folgende Code-Beispiel zeigt 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:

Siehe auch