Edytuj

Udostępnij za pośrednictwem

Manage product submissions

  • Artykuł

Use the following methods in Microsoft Hardware APIs to manage submissions for your products and for getting them signed by Microsoft. For an introduction to Microsoft Hardware APIs, including prerequisites for using the API, see Hardware dashboard API.

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

Methods for managing product submissions

Method URI Description
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Get status/data for a specific product
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Get status/data for a specific submission of a product
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Create a new product
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Create a new submission for a product
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Commit a product submission

Create and submit a product for signing

  1. Complete all the prerequisites for the Microsoft Hardware APIs.

  2. Obtain a Microsoft Entra ID access token. You must pass this access token to the methods in the Microsoft Store submission API. After you obtain an access token, you have 60 minutes to use it before it expires. After the token expires, you can obtain a new one.

  3. Create a new product by executing the following method in the Microsoft Hardware API. This method creates a new in-progress product and allows you to submit packages for this product.

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

    The response body contains a Product resource that includes the ID of this product.

  4. Create a submission for this product by executing the following method in the Microsoft Hardware API. Use the ProductID created in the previous step.

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

    The response body contains a Submission resource which includes the ID of the submission, the shared access signature (SAS) URI for uploading the product (driver) package for the submission to Azure Blob Storage. [!NOTE] > A SAS URI provides access to a secure resource in Azure storage without requiring account keys. For background information about SAS URIs and their use with Azure Blob Storage, see Grant limited access to Azure Storage resources using shared access signatures (SAS).

  5. Upload your package to the Azure Blob Storage at the location specified by the SAS URI in the previous step. The following C# code example demonstrates how to upload a package to Azure Blob Storage using the BlockBlobClient class in the Azure Storage Blobs Library for .NET. This example assumes that the package is already written to a stream object.

    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. Commit the product submission by executing the following method. This method alerts Hardware Dev Center that you're done with your product submission and validation starts for the submission.

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

  7. Check on the commit status by executing the following method to get the status of the product submission.

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

    To confirm the submission status, review the commitStatus value in the response body. This value should change from CommitReceived to CommitComplete if the request succeeds or to CommitFailed if there are errors in the request.

    Note

    The main Search page refreshes about every 10 minutes. To view all of your results as you create them, click Driver List Page (all), at the top of the Drivers page of the Partner Center. Although the page takes some time to process and load if you have a lot of submissions, both successful and unsuccessful submissions should be listed when it does load. For more info, see Find a hardware submission.

Code example

The following code example demonstrates how to use the Microsoft Hardware API:

Data resources

The Microsoft Hardware APIs methods for creating and managing product data use the following JSON data resources:

See also