管理產品提交

在 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/

   回應本文包含 Product 資源 ，其中包含此產品的標識碼。

4. 在 Microsoft 硬體 API 中執行下列方法，以建立此產品的提交 。 使用在上一個步驟中建立的 ProductID。

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

   回應本文包含提交資源，其中包含提交標識符、共用存取簽章 （SAS） URI，用於上傳提交的產品（驅動程式）套件以 Azure Blob 儲存體。 [!注意] > SAS URI 可讓您存取 Azure 記憶體中的安全資源，而不需要帳戶密鑰。 如需 SAS URI 及其搭配 Azure Blob 儲存體 使用的背景資訊，請參閱使用共用存取簽章授與有限存取權給 Azure 儲存體 資源。

5. 將套件上傳至上一個步驟中 SAS URI 所指定位置的 Azure Blob 儲存體。 下列 C# 程式代碼範例示範如何使用 Azure 儲存體 Blobs Library for .NET 中的 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）