Dela via


Skapa en ny produkt

Använd den här metoden i Microsoft Hardware API för att skapa en ny maskinvaruprodukt.

Förutsättningar

Om du inte redan har gjort det slutför du alla krav för Microsofts maskinvaru-API:er innan du försöker använda någon av dessa metoder.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begäran om URI
Posten https://manage.devcenter.microsoft.com/v2.0/my/hardware/products

Förfrågningshuvudrad

Header Typ Beskrivning
Auktorisering sträng Obligatoriskt. Microsoft Entra ID-åtkomsttoken i form av Bearer<token>.
acceptera sträng Valfritt. Anger typ av innehåll. Det tillåtna värdet är "application/json"

Parametrar för begäran

Ange inte begäransparametrar för den här metoden.

begäranens innehåll

I följande exempel visas JSON-begärandetexten för att skapa en ny produkt. Mer information om värdena i begärandetexten finns i tabellen under 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": {}
}

Mer information om fälten i begäran finns i Produktresurs.

Exempel på begäran

I följande exempel visas hur du skapar en ny produkt.

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

Svar

I följande exempel visas JSON-svarstexten som returneras av en lyckad begäran om att skapa en produkt. Mer information om värdena i svarstexten finns i följande avsnitt.

{
  "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"
}

Svarsdel

Mer information finns i Produktresurs

Felkoder

Mer information finns i Felkoder.

Se även

Exempel på maskinvaruinstrumentpanelens API (GitHub)