Partager via


Créer un produit

Utilisez cette méthode dans l’API matériel Microsoft pour créer un produit matériel.

Prérequis

Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour les API de matériel Microsoft avant d’essayer d’utiliser l’une de ces méthodes.

Requête

Cette méthode présente la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.

Méthode URI de demande
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès d’ID Microsoft Entra sous la forme Jeton> du porteur<.
accepter string facultatif. Spécifie le type de contenu. La valeur autorisée est « application/json »

Paramètres de la demande

Ne fournissez pas de paramètres de requête pour cette méthode.

Corps de la demande

L’exemple suivant illustre le corps de la requête JSON pour la création d’un produit. Pour plus d’informations sur les valeurs dans le corps de la demande, consultez le tableau sous le 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": {}
}

Pour plus d’informations sur les champs de la demande, reportez-vous à la ressource Product.

Exemples de demande

L’exemple suivant montre comment créer un produit.

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

response

L’exemple suivant illustre le corps de la réponse JSON retourné par une demande réussie de création d’un produit. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir la section suivante.

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

Response body

Pour plus d’informations, reportez-vous à la ressource Product .

Codes d’erreur

Pour plus d’informations, consultez Codes d’erreur.

Voir aussi

Exemples d’API de tableau de bord matériel (GitHub)