次の方法で共有

新しい製品の作成

  • [アーティクル]

MicrosoftハードウェアAPIでこのメソッドを使用して、新しいハードウェア製品を作成します。

前提条件

Microsoft ハードウェア API に関するすべての 前提条件 がまだ満たされていない場合は、ここに記載されているメソッドを使用する前に前提条件を整えてください。

要求

このメソッドの構文は次のとおりです。 ヘッダーと要求本文の使用例と説明については、次のセクションをご覧ください。

認証方法 要求 URI
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products

要求ヘッダー

Header 型 説明
承認 string 必須。 Bearer<token> 形式の Microsoft Entra ID アクセス トークン。
accept string 省略可能。 コンテンツの種類を指定します。 使用できる値は "application/json" です

要求パラメーター

このメソッドの要求パラメーターは指定しないでください

要求本文

次の例は、新しい製品を作成するための JSON リクエスト本文を示しています。 リクエスト本文の値の詳細については、json の下の表を参照してください。

{
  "productName": "Test_Network_Product2-R",
  "testHarness": "Attestation",
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {}
}

要求のフィールドの詳細については 申請リソースを参照してください。

要求の例

次の例は、新しい製品を作成する方法を示しています。

POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products HTTP/1.1
Authorization: Bearer <your access token>

回答

次の例は、製品作成の成功したリクエストによって返される JSON 応答本文を示しています。 応答本文の値について詳しくは、次のセクションをご覧ください。

{
  "id": 14631253285588838,
  "sharedProductId": 1152921504607010608,
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": false,
  "isExtensionInf": false,
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "productName": "VST_apdevtest1",
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {},
  "testHarness": "attestation"
}

応答の本文

詳細については 製品リソース を参照してください

エラー コード

詳細については、 エラー コードをご覧ください

関連項目

ハードウェア ダッシュボード API のサンプル (GitHub)