管理产品提交

使用 Microsoft 硬件 API 中的以下方法管理产品提交并让 Microsoft 对产品签名。 有关 Microsoft 硬件 API 的简介，包括使用该 API 的先决条件，请参阅硬件仪表板 API。

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

管理产品提交的方法

创建并提交项目以便签署

1. 完成 Microsoft 硬件 API 的所有先决条件。

2. 获取 Microsoft Entra ID 访问令牌。 在 Microsoft Store 提交 API 中，必须将此访问令牌传递给相关方法。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 该令牌到期后，可以获取新的令牌。

3. 通过执行 Microsoft 硬件 API 中的以下方法创建新产品。 此方法可创建一个新的进行中产品，并允许为该产品提交程序包。

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

   响应正文包含一个产品资源，其中包括此产品的 ID。

4. 通过执行 Microsoft 硬件 API 中的以下方法为此产品创建新提交。 使用上一步创建的 ProductID。

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

   响应正文包含提交资源，此资源包括提交 ID、用于上传产品（驱动程序）包以提交到 Azure Blob 存储的共享访问签名 (SAS) URI。

   注意

   SAS URI 提供对 Azure 存储中安全资源的访问权限，而无需帐户密钥。 有关 SAS URI 及其与 Azure Blob 存储一起使用的背景信息，请参阅使用共享访问签名 (SAS) 授予对 Azure 存储资源的有限访问权限。

5. 将您的程序包上传到由上一个步骤中的 SAS URI 指定的 Azure Blob 存储位置。 以下 C# 代码示例演示如何使用适用于 .NET 的 Azure 存储 Blob 库中的 BlockBlobClient 类将包上传到 Azure Blob 存储。 此示例假定程序包已经写入流对象。

   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. 通过执行以下方法提交产品。 这方法会通知硬件开发人员中心你已完成产品提交并将开始对提交进行验证。

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

7. 通过执行以下方法来检查提交状态以获取产品提交的状态。

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

   要确认提交状态，请查看响应正文中的commitStatus值。 如果请求成功，此值应从 CommitReceived 更改为 CommitComplete；如果请求中出现错误，此值应更改为 CommitFailed。

   注意

   “搜索”主页大约每隔 10 分钟刷新一次。 要在创建时查看所有结果，请单击合作伙伴中心的“驱动程序”页顶部的“驱动程序列表页(全部)”。 如果提交了大量的请求，页面处理和加载需要花费一段时间，不过，在加载后，应会列出成功和失败的提交。 有关详细信息，请参阅查找硬件提交。

代码示例

以下代码示例演示了如何使用 Microsoft 硬件 API：

• C# 示例

数据资源

用于创建和管理产品数据的 Microsoft 硬件 API 方法使用以下 JSON 数据资源：

• 产品资源
• 提交资源

另请参阅

• 硬件仪表板 API 示例 (GitHub)