建立新的產品

在 Microsoft 硬體 API 中使用此方法來建立新的硬體產品。

必要條件

如果您尚未這麼做，請先完成 Microsoft 硬體 API 的所有 必要條件 ，再嘗試使用這些方法。

要求

這個方法的語法如下。 請參閱下列各小節了解標頭和要求主體的使用範例和描述。

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

要求標頭

標頭	類型	描述
授權	字串	必要。 Microsoft Entra持有人< 權杖形式的識別碼存取權杖 > 。
accept	字串	選擇性。 指定內容類型。 允許的值為 「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"
}

回應本文

如需詳細資訊，請參閱產品資源

錯誤碼

如需詳細資訊，請參閱 錯誤碼。

另請參閱

GitHub) (硬體儀表板 API 範例