建立新的產品
在 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"
}
回應本文
如需詳細資訊，請參閱產品資源
錯誤碼
如需詳細資訊，請參閱 錯誤碼。