管理產品提交

使用 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	認可產品提交

建立並提交要簽署的產品

1. 如果您尚未這麼做，請完成 Microsoft 硬體 API 的所有 必要條件 。

2. 取得 Azure AD 存取權杖。 您必須將此存取權杖傳遞至 Microsoft Store 提交 API 中的方法。 在您取得存取權杖之後，您有 60 分鐘的使用時間，之後其便會到期。 權杖到期之後，您可以取得新的權杖。

3. 在 Microsoft 硬體 API 中執行下列方法來建立新產品。 這會建立新的進行中產品，並可讓您提交本產品的套件。

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

   回應本文包含包含此產品識別碼的產品 資源 。

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 儲存體使用的背景資訊，請參閱 共用存取簽章，第 1 部分：瞭解 SAS 模型 和 共用存取簽章，第 2 部分：使用 Blob 儲存體建立和使用 SAS 。

5. 將套件上傳 至上一個步驟中 SAS URI 所指定位置的 Azure Blob 儲存體。 下列 C# 程式碼範例示範如何使用適用于 .NET 的 Azure 儲存體用戶端程式庫中的 CloudBlockBlob 類別，將套件上傳至 Azure Blob 儲存體。 這個範例假設封裝已經寫入資料流程物件。

   string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
   Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
       new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
   await blockBob.UploadFromStreamAsync(stream);
   

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 資料資源：

• 產品資源
• 提交資源

另請參閱

• GitHub) (硬體儀表板 API 範例