次の方法で共有

製品申請を管理する

  • [アーティクル]

MicrosoftハードウェアAPIの次のメソッドを使用して、製品の申請を管理し、Microsoftによる署名を取得します。 API を使用するための前提条件など、Microsoft Hardware API の概要については、「Hardware dashboard 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 でのその使用に関する背景情報については、「Shared Access Signatures (SAS) を使用して Azure Storage リソースへの制限付きアクセスを許可する」を参照してください。

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

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

    Note

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

コードの例

次のコード例は、Microsoft ハードウェア API を呼び出す方法を示しています。

データ リソース

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

関連項目