管理產品提交

發行項
01/10/2024

使用 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識別碼存取令牌。您必須將此存取權杖傳遞至 Microsoft Store 提交 API 中的方法。在您取得存取權杖之後，您有 60 分鐘的使用時間，之後其便會到期。權杖到期之後，您可以取得新的權杖。
在 Microsoft 硬體 API 中執行下列方法來建立新產品。這會建立新的進行中產品，並可讓您提交本產品的套件。
```
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/
```
回應本文包含包含此產品標識碼的產品資源。
在 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。

將套件上傳至上一個步驟中 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);

執行下列方法來認可產品提交。這會向硬體開發人員中心發出警示，指出您已完成產品提交，並開始進行提交驗證。
```
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：

C# 範例

資料資源

用來建立和管理產品數據的 Microsoft 硬體 API 方法會使用下列 JSON 數據資源：

另請參閱

GitHub) (硬體儀錶板 API 範例