Condividi tramite


Creare un nuovo prodotto

Usare questo metodo nell'API Hardware Microsoft per creare un nuovo prodotto hardware.

Prerequisiti

Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi.

Richiesta

La sintassi di questo metodo è la seguente. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.

Metodo URI richiesta
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products

Intestazione della richiesta

Intestazione Tipo Descrizione
Autorizzazione string Obbligatorio. Token di accesso Microsoft Entra ID nel formato Token>di connessione<.
Accettare string Facoltativa. Specifica il tipo di contenuto. Il valore consentito è "application/json"

Parametri della richiesta

Non fornire parametri di richiesta per questo metodo.

Testo della richiesta

L'esempio seguente illustra il corpo della richiesta JSON per la creazione di un nuovo prodotto. Per altri dettagli sui valori nel corpo della richiesta, vedere la tabella sotto il codice 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": {}
}

Per informazioni dettagliate sui campi nella richiesta, vedere Risorsa prodotto.

Esempi di richiesta

Nell'esempio seguente viene illustrato come creare un nuovo prodotto.

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

Risposta

L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita per la creazione di un prodotto. Per altri dettagli sui valori nel contenuto della risposta, vedi la sezione seguente.

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

Corpo della risposta

Per altri dettagli, vedere Risorsa prodotto

Codici di errore

Per altre info, vedi Codici di errore.

Vedi anche

Esempi di API del dashboard hardware (GitHub)