Partager via


Créer une soumission pour un produit

Utilisez cette méthode dans l’API matériel Microsoft pour créer une soumission pour un produit. Avant d’utiliser cette méthode, vérifiez que vous avez créé un produit. Pour plus d’informations, consultez Créer un produit.

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/{productID}/submissions

Le productId dans la méthode est le produit pour lequel la soumission est destinée.

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 Optionnel. 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’une soumission.

{
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

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

Exemples de demande

L’exemple suivant montre comment créer une soumission.

POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions 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’une soumission pour un produit. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir la section suivante.

{
  "id": 1152921504621465124,
  "productId": 14631253285588838,
  "downloads": {
    "items": [
      {
        "type": "initialPackage",
        "url": "<SAS URL from Hardware API>"
      }
    ],
    "messages": []
  },
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "update_submission",
      "method": "PATCH"
    }
  ],
  "commitStatus": "commitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

Response body

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

Codes d’erreur

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

Voir aussi

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