管理产品提交
使用 Microsoft 硬件 API 中的以下方法管理产品提交并让 Microsoft 对产品签名。 有关 Microsoft 硬件 API 的简介,包括使用该 API 的先决条件,请参阅硬件仪表板 API。
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/
管理产品提交的方法
方法 | URI | 说明 |
---|---|---|
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} |
获取某个特定产品的状态/数据 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} |
获取产品的特定提交的状态/数据 |
POST | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products |
创建新产品 |
POST | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ |
为产品创建新的提交 |
POST | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit |
确认产品提交 |
创建并提交产品以进行签名
完成 Microsoft 硬件 API 的所有先决条件。
获取 Microsoft Entra ID 访问令牌。 在 Microsoft Store 提交 API 中,必须将此访问令牌传递给相关方法。 获取访问令牌后,在它到期前,你有 60 分钟的使用时间。 该令牌到期后,可以获取新的令牌。
通过执行 Microsoft 硬件 API 中的以下方法创建新产品。 此方法可创建一个新的进行中产品,并允许为该产品提交程序包。
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/
响应正文包含产品资源,此资源包括此产品的 ID。
通过执行 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 存储资源的有限访问权限。
上传你的程序包到 Azure Blob 存储中的某个位置,此位置由上一个步骤中的 SAS URI 指定。 以下 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); }
通过执行以下方法确认产品提交。 这方法会通知硬件开发人员中心你已完成产品提交并将开始对提交进行验证。
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit
通过执行以下方法来检查提交状态以获取产品提交的状态。
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}
要确认提交状态,请查看响应正文中的 commitStatus 值。 如果请求成功,此值应该从 CommitReceived 更改为 CommitComplete;如果请求中存在错误,此值应该更改为 CommitFailed。
注意
“搜索”主页大约每隔 10 分钟刷新一次。 要在创建时查看所有结果,请单击合作伙伴中心的“驱动程序”页顶部的“驱动程序列表页(全部)”。 如果提交了大量的请求,页面处理和加载需要花费一段时间,不过,在加载后,应会列出成功和失败的提交。 有关详细信息,请参阅查找硬件提交。
代码示例
以下代码示例演示了如何使用 Microsoft 硬件 API:
数据资源
用于创建和管理产品数据的 Microsoft 硬件 API 方法使用以下 JSON 数据资源: