Obtenir les données du produit

Article
10/03/2024

Utilisez les méthodes suivantes des API matérielles de Microsoft pour récupérer les données relatives aux produits matériels enregistrés dans votre compte Centre de développement matériel. Pour une introduction aux API matérielles de Microsoft, y compris les conditions préalables à l'utilisation de l'API, voir Gérer les soumissions de matériel à l'aide des API.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Pour pouvoir utiliser ces méthodes, le produit doit déjà exister dans votre compte Dev Center. Pour créer ou gérer des soumissions de produits, consultez les méthodes de la section Gérer les soumissions de produits.

Method	URI	Description
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/`	Obtenir des données pour tous vos produits
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}`	Obtenir des données pour un produit spécifique
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions`	Obtenir des données pour toutes les soumissions d'un produit
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}`	Obtenir des données pour une soumission spécifique d'un produit

Prérequis

Remplissez toutes les conditions préalables pour les API matérielles de Microsoft avant d'essayer d'utiliser l'une de ces méthodes.

Ressources de données

Les méthodes des API matérielles de Microsoft permettant d'obtenir des données sur les produits utilisent les ressources de données JSON suivantes

Ressource de produit

Cette ressource représente un produit matériel (pilote) enregistré dans votre compte.

{
  "id": 9007199267351834,
  "sharedProductId": 1152921504606971100,
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": true,
  "isExtensionInf": false, "_comment": "This field is deprecated and moved to submission resource",
  "deviceMetadataIds": [],
  "deviceType": "notSet",
  "isTestSign": false,
  "isFlightSign": false,
  "marketingNames": [
    "marketing name 1",
    "marketing name 2"
],
  "productName": "product name",
  "selectedProductTypes": {
    "windows_v100Server": "Unclassified",
    "windows_v100": "Unclassified"
},
  "requestedSignatures": [
    "WINDOWS_v100_X64_TH1_FULL",
    "WINDOWS_v63_X64"
  ],
  "additionalAttributes": {},
  "testHarness": "hlk",
  "announcementDate": "2016-10-22T00:00:00Z",
}

Cette ressource possède les valeurs suivantes

Valeur	Type	Description
ID	Long	L'ID privé du produit
sharedProductId	Long	L'ID partagé du produit.
Liens	tableau d'objets	Reportez-vous à l'objet lien pour plus de détails.
isCommitted	Boolean	Indique si le produit a au moins une soumission validée.
isExtensionInf	Boolean	(OBSOLÈTE) Indique si le produit est un pilote d'extension. Ce champ est obsolète et ne doit plus être utilisé. isExtensionInf a été déplacé vers une propriété au niveau de la soumission.
deviceMetadataIds	tableau de GUID	GUIDs qui mappent les soumissions de métadonnées d'appareil au pilote.
deviceType	Chaîne	Indique le type d'appareil. Les valeurs possibles sont les suivantes : « internal » - Un composant interne, l'appareil fait partie d'un système et se connecte à l'intérieur du PC. « external » - Un composant externe, l'appareil est un appareil externe (périphérique) qui se connecte à un PC. « internalExternal » - Les deux, l'appareil peut être connecté en interne (à l'intérieur d'un PC) et en externe (périphérique). « notSet » - aucune donnée disponible
isTestSign	Boolean	Indique si le produit est un pilote signé en test. Pour plus d'informations sur la signature de test des packages de pilotes, consultez le programme de signature de test WHQL.
isFlightSign	Boolean	Indique si le produit est un pilote signé en vol. Les pilotes signés en vol sont des pilotes de test qui peuvent être publiés via Windows Update. Ils ne peuvent être publiés/installés que sur les machines inscrites au programme Windows Insider. Ils peuvent être installés sur des machines sans désactiver le démarrage sécurisé. Ils ne peuvent pas être installés sur des machines au détail qui ne font pas partie du programme Windows Insider.
marketingNames	tableau de chaînes	Noms marketing ou alias du produit
productName	Chaîne	Le nom du pilote tel qu'il est spécifié lors de la création.
selectedProductTypes	dictionnaire	Appairage clé-valeur où les deux sont des chaînes de caractères. La clé représente le code de la famille du système d'exploitation. Pour obtenir une liste des codes de famille de systèmes d'exploitation, consultez la liste des codes de famille de systèmes d'exploitation. La valeur représente le type de produit. Pour une liste des types de produits, voir types de produits.
requestedSignatures	tableau de chaînes	Liste des signatures de systèmes d'exploitation pour lesquels le produit est certifié. Pour une liste de tous les systèmes d'exploitation, voir la liste des codes de système d'exploitation.
additionalAttributes	Object	Pour plus d'informations, voir l'objet attributs supplémentaires.
testHarness	string	Le type de package soumis. Les valeurs possibles sont les suivantes : hLK hck attestation notset
announcementDate	DATETIME	La date à laquelle le produit est inclus dans le catalogue Windows Server.

Ressource de soumission

Cette ressource représente la soumission d'un produit.

{
  "id": 1152921504621442000,
  "productId": 13635057453741328,
   "workflowStatus": {
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    },
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/13635057453741329/submissions/1152921504621441944",
      "rel": "self",
      "method": "GET"
    }
  ],
  "commitStatus": "CommitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "HARRY-Duatest2",
  "type": "derived"
}

Cette ressource a les valeurs suivantes :

Valeur	Type	Description
ID	long	L'ID de la soumission
Productid	long	L'ID du produit privé auquel cette soumission est associée.
état du flux de travail	object	Cette ressource n'est disponible que lors de la récupération des détails d'une soumission spécifique. Cet objet décrit l'état du workflow pour cette soumission. Pour plus d'informations, voir l'objet workflow status.
Liens	tableau d'objets	Reportez-vous à l'objet lien pour plus de détails.
commitStatus	Pour plus d'informations, reportez-vous à la section Gérer les soumissions de produits.
isExtensionInf	Boolean	Indique si la soumission est un pilote d'extension.
isUniversal	Boolean	Indique si la soumission passe le test de l'API universelle. Un pilote est conforme à la DCHU s'il est déclaratif et universel.
isDeclarativeInf	Boolean	Indique si la soumission passe le test INVerif déclaratif. Un pilote est conforme au DCHU s'il est déclaratif et universel.
Nom	chaîne	Le nom de la soumission.
Type	string	Indique s'il s'agit d'une soumission initiale ou dérivée. Les valeurs possibles sont les suivantes : initiale dérivés
téléchargements	object	Cet objet n'est disponible que pour la récupération des détails d'une soumission spécifique. Cet objet décrit les téléchargements disponibles pour la soumission. Pour plus d'informations, voir l'objet téléchargement.

Objet Statut du workflow

Cet objet représente le statut du workflow pour une entité donnée

{
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    }

Cet objet possède les valeurs suivantes

Valeur	Type	Description
currentStep	string	Le nom de l'étape actuelle du workflow global pour cette entité. Pour la soumission d'une ingestion ou d'un package, les valeurs possibles sont les suivantes (description entre parenthèses) : packageInfoValidation (Validation des métadonnées et du contenu du package) préparation (préparation du package en vue de son traitement) scanning (Analyse du contenu du package à la recherche de logiciels malveillants) validation (validation des résultats des tests) catalogCreation (Création d'un catalogue de sécurité pour le package) manualReview (Examen manuel) signing (Signature des binaires) finalizeIngestion (achèvement de l'ingestion et préparation des fichiers signés pour le téléchargement ou la publication)
État	chaîne	L'état de l'étape en cours. Les valeurs possibles sont les suivantes : notStarted démarré échec terminé
Messages	tableau	Un tableau de chaînes de caractères pour fournir des messages sur l'étape en cours (en particulier en cas d'échec).

Objet Download

Cet objet représente les téléchargements pour une soumission donnée.

{
  "items": [
    {
      "type": "initialPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "derivedPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "signedPackage",
      "url": "<SAS URL from Hardware API>"
    },
    {
      "type": "certificationReport",
      "url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
    }
  ],
  "messages": []
}

Cet objet possède les valeurs suivantes

Valeur	Type	Description
Articles	tableau	Un tableau de types de téléchargements et l'URL de chacun d'entre eux.
Type	string	Le type de package disponible pour le téléchargement. Les valeurs possibles sont les suivantes : « initialPackage » - package chargé par l'utilisateur (pour une nouvelle soumission, il pointe vers l'URI SAS pour charger le package) « derivedPackage » - interpréteur de commande pour les soumissions dérivées. « signedPackage » - package signé par Microsoft « certificationReport » - rapport de certification pour le produit signé driverMetadata » - lien vers un fichier permettant de télécharger les métadonnées du pilote. Pour plus d'informations, voir les métadonnées du package du pilote. ExternalNotes Inconnu
Messages	tableau	Un tableau de chaînes de caractères pour fournir des messages sur les fichiers téléchargeables.

Objet lien

Cet objet représente une liste de liens utiles pour l'entité contenante.

{
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    }

Cet objet possède les valeurs suivantes

Valeur	Type	Description
Href	Chaîne	L'URL permettant d'accéder à la ressource via l'API
Rel	Chaîne	Type de la ressource. Les valeurs possibles sont les suivantes : self - Le lien pointe vers lui-même next_link - Le lien pointe vers la ressource suivante, généralement utilisée pour la pagination. get_submissions - lien vers toutes les soumissions d'un produit commit_submission - lien vers la validation d'une soumission update_submission - lien vers la mise à jour de la soumission update_shippinglabel - lien vers la mise à jour de l'étiquette d'expédition
Method	Chaîne	Type de méthode http à utiliser lors de l'invocation de l'URL. Les valeurs possibles sont les suivantes : GET POST PATCH

Objet Attributs supplémentaires

Cet objet fournit des attributs supplémentaires sur le produit s'il s'agit d'un contrôleur RAID, d'un contrôleur de stockage ou d'un programme de validation de la virtualisation des serveurs (SVVP). Il peut contenir l'un des trois types d'objets suivants : StorageController, RaidController ou SVVP.

Objet StorageController

Valeur	Type	Description
biosVersion	string	Version du bios ROM
firmwareVersion	string	Version du microprogramme
driverVersion	string	Version du pilote
driverName	string	Driver Name (Nom du pilote)
deviceVersion	string	Version de l’appareil
chipsetName	string	Nom du chipset
usedProprietary	booléen	Le multi-pathing est pris en charge par le pilote propriétaire. Si c'est le cas, proprietaryName et proprietaryVersion sont obligatoires.
proprietaryName	string	Nom du logiciel multitrajet
proprietaryVersion	string	Version du logiciel multitrajet
usedMicrosoft	booléen	Microsoft MPIO pris en charge par un module spécifique à l'appareil. Si la réponse est oui, les champs microsoftName et microsoftVersion sont obligatoires.
microsoftName	string	Nom du logiciel multitrajet
microsoftVersion	string	Version du logiciel multitrajet
usedBootSupport	booléen	Prise en charge de l'amorçage
usedBetterBoot	booléen	Boot > 2.2-TB support. Si vrai, la version UEFI prise en charge et la version ACPI prise en charge sont obligatoires.
uefiVersion	string	Version de l’UEFI prise en charge
acpiVersion	string	Version de l’ACPI prise en charge
supportsSector4K512E	booléen	Prise en charge de la taille de secteur 4K/512e
supportsSector4K4K	booléen	Prise en charge de la taille de secteur de 4K/4K
supportsDifferential	booléen	Différentiel (différentiel haute tension)

Objet RaidController

Valeur	Type	Description
firmwareVersion	string	Version du microprogramme
filterVersion	string	Version du pilote
driverVersion	string	Version du filtre
usedProprietary	booléen	Le multi-pathing est pris en charge par le pilote propriétaire. Si vrai, alors proprietaryName et proprietaryVersion sont obligatoires
proprietaryName	string	Nom du logiciel multitrajet
proprietaryVersion	string	Version du logiciel multitrajet
usedMicrosoft	booléen	Microsoft MPIO pris en charge par un module spécifique à l'appareil. Si vrai, alors microsoftName et microsoftVersion sont obligatoires
microsoftName	string	Nom du logiciel multitrajet
microsoftVersion	string	Version du logiciel multitrajet
isThirdPartyNeeded	booléen	Pilote non Microsoft nécessaire pour la connectivité
isSES	booléen	SES (SCSI Enclosure Services). Indique si un SES est inclus. SCSI est le terme standard pour un bus de service qui connecte les appareils sur un système, à l'origine Small Computer System Interface. SES est l'abréviation de SCSI Enclosure Services.
isSAFTE	booléen	SAF-TE (spécification ANBll). Indique si un SAF-TE est inclus. ANBll est une spécification industrielle. SAF-TE est l'abréviation de SCSI Accessed Fault Tolerant Enclosures. SCSI est le terme standard pour un bus de service qui connecte les appareils sur un système, à l'origine Small Computer System Interface.
additionalInfo	string	Informations supplémentaires

Objet SVVP

Valeur	Type	Description
productVersion	string	Version du produit
supportLink	string	URL du support technique
guestOs	string	Système d'exploitation invité. Les valeurs possibles sont les suivantes : Windows Server 2008 Windows Server 2008 Release 2 Windows Server 2012 Windows Server 2012 R2
processorArchitecture	string	Architecture du processeur matériel. Les valeurs possibles sont les suivantes : Xeon Opteron Itanium 2
maxProcessors	entier	Nombre maximal de processeurs dans la machine virtuelle
maxMemory	entier	Mémoire maximale dans la machine virtuelle (en Go)

Liste des types de produits

Un produit peut être de l'un des types suivants. Avec le système d'exploitation, cette information est utilisée pour identifier l'applicabilité.

Imprimante 3D
Capteur d'accéléromètre
Tout-en-un
Tout-en-un avec tactile
Appareil audio
Objets de traitement audio (APO)
Contrôleur Bluetooth
Contrôleur Bluetooth non USB
Appareil photo
Capteur de caméra
Cluster
Accélérateur de calcul MCDM 2.7
Accélérateur de calcul MCDM 3.1
Accélérateur de calcul MCDM 3.2
Tablette convertible
Bureau
Rendu des médias numériques
Serveur de médias numériques
Caméras numériques
Caméras vidéo numériques
Appareils compatibles avec la gestion des scans de distribution
Imprimante multifonction Enterprise WSD
Lecteur d'empreintes digitales
Contrôleur de jeu
Contrôleur générique
Appareil portable générique
Adaptateur graphique MCDM2.7
Adaptateur graphique MCDM2.8
Adaptateur graphique MCDM2.9
Adaptateur graphique MCDM3.0
Adaptateur graphique WDDM1.0
Adaptateur graphique WDDM1.1
Adaptateur graphique WDDM1.2
Adaptateur graphique WDDM1.2 DisplayOnly
Adaptateur graphique WDDM1.2 RenderOnly
Adaptateur graphique WDDM1.3
Adaptateur graphique WDDM1.3 DisplayOnly
Adaptateur graphique WDDM1.3 RenderOnly
Adaptateur graphique WDDM2.0
Adaptateur graphique WDDM2.0 Affichage seulement
Adaptateur graphique WDDM2.0 Rendu uniquement
Adaptateur graphique WDDM2.1
Adaptateur graphique WDDM2.1 Affichage seulement
Adaptateur graphique WDDM2.1 Rendu uniquement
Adaptateur graphique WDDM2.2
Adaptateur graphique WDDM2.2 Affichage seulement
Adaptateur graphique WDDM2.2 Rendu uniquement
Adaptateur graphique WDDM2.3
Adaptateur graphique WDDM2.3 Affichage seulement
Adaptateur graphique WDDM2.3 Rendu uniquement
Adaptateur graphique WDDM2.4
Adaptateur graphique WDDM2.4 Affichage seulement
Adaptateur graphique WDDM2.4 Rendu uniquement
Adaptateur graphique WDDM2.4 Machine virtuelle
Adaptateur graphique WDDM2.5
Adaptateur graphique WDDM2.5 Affichage seulement
Adaptateur graphique WDDM2.5 Rendu uniquement
Adaptateur graphique WDDM2.5 VM
Adaptateur graphique WDDM2.6
Adaptateur graphique WDDM2.6 Affichage seulement
Adaptateur graphique WDDM2.6 Rendu uniquement
Adaptateur graphique WDDM2.6 VM
Adaptateur graphique WDDM2.7
Adaptateur graphique WDDM2.7 Affichage seulement
Adaptateur graphique WDDM2.7 Rendu uniquement
Adaptateur graphique WDDM2.7 VM
Adaptateur graphique WDDM2.8
Adaptateur graphique WDDM2.8 Affichage seulement
Adaptateur graphique WDDM2.8 Rendu uniquement
Adaptateur graphique WDDM2.8 VM
Adaptateur graphique WDDM2.9
Adaptateur graphique WDDM2.9 Affichage seulement
Adaptateur graphique WDDM2.9 Rendu uniquement
Adaptateur graphique WDDM2.9 VM
Adaptateur graphique WDDM3.0
Adaptateur graphique WDDM3.0 Affichage seulement
Adaptateur graphique WDDM3.0 Rendu uniquement
Adaptateur graphique WDDM3.0 VM
Adaptateur graphique WDDM3.1
Adaptateur graphique WDDM3.1 Affichage seulement
Adaptateur graphique WDDM3.1 Rendu uniquement
Adaptateur graphique WDDM3.1 VM
Adaptateur graphique WDDM3.2
Adaptateur graphique WDDM3.2 Affichage seulement
Adaptateur graphique WDDM3.2 Rendu uniquement
Adaptateur graphique WDDM3.2 VM
Tablette graphique
Capteur gyroscopique
Disque dur
Transformateurs multifonctions matériels
Clavier
Clavier Vidéo Souris Interrupteur
LAN
LAN (serveur)
LAN CS
Machine virtuelle LAN (serveur)
Portable
Ordinateur portable avec écran tactile
LCD
Capteur de lumière
Capteur de localisation
Lecteur multimédia
Mobile à large bande CDMA
Mobile à large bande GSM
Téléphone mobile
Monitor
Carte mère
Capteur de mouvement Fusion
Imprimante multifonction
Proximité en champ proche
Appareil de média en réseau
NFC
Lecteur de carte à puce NFC
Lecteur optique
Stylet Numériseur
Dessin de pointage
Pavé tactile de précision
Capteur de présence
Imprimante
Projecteur
Stockage amovible
Routeur
Scanneur
Contrôleur SDIO
Serveur
Programme de validation de la virtualisation du serveur
Tablette de signature
Cartes à puce
Lecteur de carte à puce
Groupe de stockage
Contrôleur de stockage
Adaptateur d'espace de stockage
Lecteur d'espace de stockage
Tablette
Toucher
Moniteur tactile
TPM20
PC ultra-mobile
PC ultra-mobile avec écran tactile
Contrôleur USB
Concentrateur USB
Webcam
WLAN
WLAN CSB
Imprimante multifonction WSD
Imprimante WSD
Scanneur WSD

Liste des codes de famille du système d'exploitation

Le tableau suivant répertorie les codes de famille des systèmes d'exploitation et leur description.

Code de famille du système d'exploitation	Description
WindowsMe	Windows Me
Windows2000	Windows 2000
Windows98	Windows 98
WindowsNT40	Windows NT 4.0
WindowsXP	Windows XP
WindowsServer2003	Windows Server 2003
WindowsVista	Windows Vista
Windows2008Server	Windows Server 2008
WindowsHomeServer	Windows Home Server
Windows7	Windows 7
Windows2008ServerR2	Windows Server 2008 Release 2
WindowsServerSolutions	Solutions pour serveurs Windows
Windows8	Windows 8
Windows8Server	Windows Server 2012
Windows81	Windows 8.1
Windows81Server	Windows Server 2012 R2
Windows_v100	Seuil Windows 10
Windows_v100Server	Windows Server Threshold
Windows_v100_RS1	Mise à jour anniversaire Windows 10
Windows_v100Server_RS1	Windows Server 2016
Windows_v100_RS2	Mise à jour Windows 10 RS2
Windows_v100Server_RS2	Windows Server RS2
Windows_v100_RS3	Mise à jour de Windows 10 RS3
Windows_v100Server_RS3	Windows Server RS3
Windows_v100_RS4	Mise à jour de Windows 10 RS4
Windows_v100Server_RS5	Windows Server 2019
Windows_v100_RS5	Windows 10 RS5 x86
Windows_v100_RS5	Windows 10 RS5 x64
Windows_v100_19H1	Mise à jour de Windows 10 19H1
Windows_v100_VB	Windows 10 version 2004
Windows_v100Server_FE	Windows - Serveur, version 21H2
Windows_v100_CO	Windows - Client, version 21H2
Windows_v100_NI	Windows 11 Client, version 22H2
Windows_v100_GE	Windows 11 Client, version 24H2
Windows_v100Server_GE	Windows Server 2025

Liste des codes de système d'exploitation

Le tableau suivant donne la liste des codes de système d'exploitation et leur description.

Code du système d'exploitation	Description
WINDOWS_ME	Windows Me
WINDOWS_98	Windows 98
WINDOWS_2000	Windows 2000
WINDOWS_NT40	Windows NT 4.0
WINDOWS_XP	Windows XP
WINDOWS_XP_IA64	Windows XP IA64
WINDOWS_XP_X64	Windows XP X64
WINDOWS_XP_MEDIA_CENTER	Windows XP Media Center
WINDOWS_2003	Windows Server 2003
WINDOWS_2003_IA64	Windows Server 2003 IA64
WINDOWS_2003_X64	Windows Server 2003 X64
WINDOWS_VISTA	Windows Vista Client
WINDOWS_VISTA_X64	Windows Vista Client X64
WINDOWS_2008_SERVER	Windows Server 2008
WINDOWS_2008_SERVER_IA64	Windows Server 2008 IA64
WINDOWS_2008_SERVER_X64	Windows Server 2008 X64
WINDOWS_HOME_SERVER	Windows Home Server
WINDOWS_7	Client Windows 7
WINDOWS_7_X64	Windows 7 Client x64
WINDOWS_2008_SERVER_R2_IA64	Windows Server 2008 Release 2 IA64
WINDOWS_2008_SERVER_R2_X64	Windows Server 2008 Release 2 x64
WINDOWS_SERVER_SOLUTIONS_X64	Windows Server Solutions x64
WINDOWS_8	Client Windows 8
WINDOWS_8_X64	Windows 8 Client x64
WINDOWS_8_ARM	Windows 8 Client RT
WINDOWS_8_SERVER_X64	Windows Server 2012
WINDOWS_v63	Client Windows 8.1
WINDOWS_v63_X64	Windows 8.1 Client x64
WINDOWS_v63_ARM	Windows 8.1 RT Client
WINDOWS_v63_SERVER_X64	Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL	Windows 10 Client versions 1506 and 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL	Windows 10 Client versions 1506 and 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL	Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL	Windows 10 Client versions 1506 and 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL	Windows 10 Client versions 1506 and 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL	Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL	Windows 10 Client version 1607
WINDOWS_v100_X64_RS1_FULL	Windows 10 Client version 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL	Windows Server 2016 x64 (RS1)
WINDOWS_v100_RS2_FULL	Windows 10 RS2 Client
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 Client x64
WINDOWS_v100_RS3_FULL	Windows 10 RS3 Client
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 Client x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 Client Arm64
WINDOWS_v100_RS4_FULL	Windows 10 RS4 Client
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 Client x64
WINDOWS_v100_ARM64_RS4_FULL	Windows 10 RS4 Client Arm64
WINDOWS_v100_SERVER_X64_RS5_FULL	Windows Server 2019
WINDOWS_v100_RS5_FULL	Windows 10 RS5 x86
WINDOWS_v100_X64_RS5_FULL	Windows 10 RS5 Client x64
WINDOWS_v100_19H1_FULL	Windows 19H1 Client x86
WINDOWS_v100_X64_19H1_FULL	Windows 19H1 Client x64
WINDOWS_v100_ARM64_19H1_FULL	Windows 19H1 Client Arm64
WINDOWS_v100_VB_FULL	Windows 10 version 2004 x86 Client
WINDOWS_v100_X64_VB_FULL	Windows version 2004 x64 Client
WINDOWS_v100_ARM64_VB_FULL	Windows version 2004 Arm64 Client
WINDOWS_v100_SERVER_X64_FE_FULL	Windows - Server, version 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL	Windows - Server, version 21H2 Arm64
WINDOWS_v100_X64_CO_FULL	Windows - Client, version 21H2 x64
WINDOWS_v100_ARM64_CO_FULL	Windows - Client, version 21H2 Arm64
WINDOWS_v100_X64_NI_FULL	Windows 11 Client, version 22H2 x64
WINDOWS_v100_ARM64_NI_FULL	Windows 11 Client, version 22H2 Arm64
WINDOWS_v100_X64_GE_FULL	Windows 11 Client, version 24H2 x64
WINDOWS_v100_ARM64_GE_FULL	Windows 11 Client, version 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL	Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL	Windows Server 2025 ARM64

Codes d’erreur

Les codes d'erreur sont applicables à toutes les méthodes Web de l'API. Si la requête ne peut être traitée avec succès, la réponse contient l'un des codes d'erreur HTTP suivants.

État HTTP	Description
400 Demande incorrecte.	Requête mal formée (par exemple, syntaxe de requête mal formée, trame de message de requête non valide ou acheminement de requête trompeur).
401 - Non autorisé	L'authentification a échoué ou n'a pas été fournie
403 - Interdit	L'accès à une ressource est interdit.
404 - Non trouvé	L'entité de la requête n'a pas été trouvée.
415 - Type de média non pris en charge	La charge utile est dans un format non supporté par cette méthode sur la ressource cible.
422 - Entité non traitable	Échec de la validation.
429 - Trop de requêtes	Trop de requêtes sont envoyées. Les appels sont limités et le délai d'attente est indiqué dans la réponse.
500 - Erreur interne du serveur	Une erreur irrécupérable s'est produite au niveau du serveur de l'API.

En cas d'échec de la validation fonctionnelle, le corps de la réponse contient l'un des codes d'erreur fonctionnelle suivants.

Code d'erreur	Message d’erreur	Description
InvalidInput		Renvoyé en cas d'échec de la validation d'une entrée.
RequestInvalidForCurrentState	Seules les soumissions en attente peuvent être validées	Renvoyé lorsqu'une validation est appliquée à une soumission qui n'est pas en attente.
RequestInvalidForCurrentState	La soumission initiale existe déjà	Ce code est renvoyé lorsqu'une soumission initiale est créée pour un pilote qui a déjà une soumission initiale.
RequestInvalidForCurrentState	Impossible de créer une soumission dérivée car aucune soumission initiale n'a été créée.	Renvoyé lorsqu'une soumission dérivée est créée pour un pilote qui n'a pas de soumission initiale.
UpdateUnauthorized	Non autorisé à mettre à jour le produit	Ce message est renvoyé lorsque vous essayez de mettre à jour un produit qui a été partagé (revendu), car les produits partagés ne peuvent pas être mis à jour.
UpdateUnauthorized	Impossible de mettre à jour un produit sans soumission initiale	Ce message est renvoyé lorsque vous essayez de mettre à jour un produit qui n'a pas fait l'objet d'une soumission initiale.
UpdateUnauthorized	Impossible de mettre à jour un produit car le workflow a échoué.	Ce message est renvoyé lorsque vous essayez de mettre à jour un produit dont le workflow a échoué.
UpdateUnauthorized	La date d'annonce ne peut pas être mise à jour après la fin du processus d'ingestion.	Ce message est renvoyé lorsque la date d'annonce est mise à jour après la fin du processus d'ingestion.
UpdateUnauthorized	Le nom du produit ne peut pas être mis à jour pour le moment. Réessayez.
UpdateUnauthorized	Vous n'êtes pas autorisé à mettre à jour la soumission	Ce message est renvoyé lorsque vous essayez de mettre à jour une soumission pour un produit qui a été partagé (revendu), car les produits partagés ne peuvent pas être mis à jour.
UpdateUnauthorized	Impossible de mettre à jour la soumission car les workflows ont échoué.	Renvoyé lors d'une tentative de mise à jour d'une soumission dont le workflow a échoué.
EntityNotFound	Aucune soumission trouvée	Renvoyé lors d'une tentative de validation d'une soumission qui n'existe pas.
EntityNotFound	Produit non trouvé	Ce message est renvoyé lorsque l'on tente de créer une soumission pour laquelle il n'existe pas de produit.
InvalidInput	Les pilotes d'extension doivent être publiés en tant que mise à jour automatique. L'une ou l'autre des options isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems doit être vraie.	Renvoyé lorsqu'une étiquette d'expédition de mise à jour Windows pour une extension INF est créée sans choisir isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems.
InvalidInput	Les CHID ne sont autorisés que lorsque les HardwareIds sont pour les systèmes d'exploitation Windows 10 et ultérieurs.	Renvoyé lorsqu'une étiquette d'expédition ciblant un système d'exploitation inférieur à Windows 10 est créée avec le ciblage CHID. Le ciblage CHID ne s'applique qu'aux systèmes d'exploitation Windows 10 et supérieurs.
InvalidInput	Impossible de mettre à jour l'étiquette d'expédition lorsqu'un autre workflow est en cours. Réessayez.	Renvoyé lorsqu'une étiquette d'expédition est mise à jour alors qu'un workflow précédent est toujours en cours.
RequestInvalidForCurrentState	Impossible de créer une étiquette d'expédition pour une boîte de réception ou un type de système. On ne peut que partager l'étiquette d'expédition.	Renvoyé lors de la création d'une étiquette d'expédition de publication pour un pilote de boîte de réception ou un système.
RequestInvalidForCurrentState	La soumission n'est pas encore prête à créer l'étiquette d'expédition. Recommencez l’opération un peu plus tard.	Renvoyé lorsqu'une étiquette d'expédition est créée sans attendre la fin de la préparation ou du prétraitement.

Voir aussi

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

Partager via

Obtenir les données du produit

Prérequis

Ressources de données

Ressource de produit

Ressource de soumission

Objet Statut du workflow

Objet Download

Objet lien

Objet Attributs supplémentaires

Objet StorageController

Objet RaidController

Objet SVVP

Liste des types de produits

Liste des codes de famille du système d'exploitation

Liste des codes de système d'exploitation

Codes d’erreur

Voir aussi

Commentaires

Ressources supplémentaires