製品申請を管理する

  • [アーティクル]

MicrosoftハードウェアAPIの次のメソッドを使用して、製品の申請を管理し、Microsoftによる署名を取得します。 API を使用するための前提条件など、Microsoft Hardware API の概要については、「ハードウェア ダッシュボード API」をご覧ください。

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

製品の申請を管理する方法

Method 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} 製品の特定の申請の状態/データの取得
投稿 https://manage.devcenter.microsoft.com/v2.0/my/hardware/products 新しい製品の作成
投稿 https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ 製品の新しい申請の作成
投稿 https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit 製品申請のコミット

署名する製品を作成して送信します

  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を含むProductリソースが含まれます。

  4. Microsoft ハードウェア API の次のメソッドを実行して、この製品の申請を作成します。 上記の手順で作成したProductIDを使用します。

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

    応答本文に含まれる申請のリソースには、申請の ID、申請の製品 (ドライバー) パッケージを Azure Blob Storage にアップロードするための共有アクセス署名 (SAS) URI が含まれます。 [!注] > SAS URI では、アカウント キーを必要とせずに、Azure Storage 内のセキュリティで保護されたリソースにアクセスできます。 SAS URI の背景情報と Azure Blob Storage での SAS URI の使用については、「Shared Access Signatures、第 1 部: SAS モデルについて」と「Shared Access Signature、第 2 部: BLOB ストレージでの SAS の作成と使用」を参照してください。

  5. 前の手順の SAS URI で指定された場所にある Azure Blob Storage にパッケージをアップロードします。 次の C# コード例は、.NET 用 Azure Storage クライアント ライブラリの CloudBlockBlob クラスを使用して Azure Blob Storage にパッケージをアップロードする方法を示しています。 この例では、パッケージがストリームオブジェクトに既に書き込まれていることを前提としています。

    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 (要求でエラーが発生した場合) に変わっています。

    Note

    メインの検索ページは約 10 分ごとに更新されます。 作成時にすべての結果を表示するには、パートナー センターの [ドライバー] ページの上部にある [Driver List Page (all)]\(ドライバー一覧ページ (すべて)\) をクリックします。 大量の申請がある場合は、ページの処理と読み込みに時間がかかりますが、読み込み時に成功した申請と失敗した申請の両方が表示されます。 詳細については、「ハードウェア申請を検索する」を参照してください。

コード例

次のコード例は、Microsoft Hardware APIの使用方法を示しています。

データ リソース

製品データを作成および管理するためのMicrosoft Hardware APIメソッドでは、次のJSONデータリソースを使用します。

関連項目