Delen via


Productgegevens ophalen

Gebruik de volgende methoden in Microsoft Hardware-API's om gegevens op te halen voor hardwareproducten die zijn geregistreerd bij uw Dev Center-account. Zie Hardware-inzendingen beheren met behulp van API's van Microsoft voor een inleiding tot Microsoft Hardware-API's, inclusief vereisten voor het gebruik van de API.

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

Voordat u deze methoden kunt gebruiken, moet het product al bestaan in uw Dev Center-account. Als u verzendingen voor producten wilt maken of beheren, raadpleegt u de methoden in Productinzendingen beheren.

Methode URI (Uniform Resource Identifier) Beschrijving
Ophalen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ Gegevens ophalen voor al uw producten
Ophalen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Gegevens ophalen voor een specifiek product
Ophalen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions Gegevens ophalen voor alle verzendingen van een product
Ophalen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Gegevens ophalen voor een specifieke verzending van een product

Vereiste voorwaarden

Voltooi alle vereisten voor de Microsoft Hardware-API's voordat u een van deze methoden probeert te gebruiken.

Gegevensbronnen

De Microsoft Hardware-API's voor het ophalen van productgegevens gebruiken de volgende JSON-gegevensbronnen

Producthulpbron

Deze resource vertegenwoordigt een hardwareproduct (stuurprogramma) dat is geregistreerd bij uw account.

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

Deze resource heeft de volgende waarden

Waarde Typologie Beschrijving
Identiteitsbewijs Lang De persoonlijke product-id van het product
sharedProductId Lang De gedeelde product-id van het product
Verwijzingen reeks van objecten Raadpleeg het koppelingsobject voor meer informatie
isToegewijd Booleaan Geeft aan of het product ten minste één vastgelegde inzending heeft
isExtensionInf Booleaan (AFGESCHAFT) Geeft aan of het product een extensiestuurprogramma is. Dit veld is afgeschaft en mag niet meer worden gebruikt. isExtensionInf verplaatst naar een eigenschap op indieningsniveau.
deviceMetadataIds array van GUIDs GUIDs waarmee metagegevens van het apparaat worden gekoppeld aan het stuurprogramma
apparaatstype Snaar / Touwtje Geeft het type apparaat aan. Mogelijke waarden zijn:
  • "intern" - Een intern onderdeel, apparaat maakt deel uit van een systeem en maakt verbinding binnen de pc
  • "extern" - Een extern onderdeel, apparaat is een extern apparaat (randapparaat) dat verbinding maakt met een pc
  • "internalExternal": het apparaat kan zowel intern (in een pc) als extern (als randapparaat) worden aangesloten.
  • 'notSet': er zijn geen gegevens beschikbaar
isTestSign Booleaan Geeft aan of het product een testondertekend stuurprogramma is. Zie WHQL Test Signature Program voor meer informatie over stuurprogrammapakketten voor testondertekening
isFlightSign Booleaan Geeft aan of het product een door een vlucht ondertekend stuurprogramma is. Vluchtondertekende stuurprogramma's zijn teststuurprogramma's die kunnen worden gepubliceerd via Windows Update. Ze kunnen alleen worden gepubliceerd/geïnstalleerd op computers die zijn geregistreerd voor het Windows Insider-programma. Ze kunnen op computers worden geïnstalleerd zonder beveiligd opstarten uit te schakelen. Ze kunnen niet worden geïnstalleerd op retailcomputers die geen deel uitmaken van het Windows Insider-programma.
marketingNames reeks van tekenreeksen Marketingnamen of aliassen van het product
productnaam Snaar / Touwtje De naam van het stuurprogramma zoals opgegeven tijdens het maken
geselecteerdeProducttypen woordenboek Sleutel-waardepaar waarbij beide tekenreeksen zijn.
aangevraagde handtekeningen reeks van tekenreeksen Lijst met handtekeningen van besturingssystemen waarvoor het product is gecertificeerd. Zie de lijst met besturingssysteemcodes voor een lijst met alle besturingssystemen.
aanvullende attributen Voorwerp Zie voor meer informatie het extra kenmerkobject.
testHarness touw Het type pakket dat is ingediend. Mogelijke waarden zijn:
  • hlk
  • hck
  • attestatie
  • niet ingesteld
aankondigingsdatum datum/tijd De datum waarop het product wordt opgenomen in de Windows Server-catalogus.

Inzendingshulpmiddel

Deze resource vertegenwoordigt een verzending van een product.

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

Deze resource heeft de volgende waarden:

Waarde Typologie Beschrijving
Identiteitsbewijs lang De id van de inzending
Productid lang De persoonlijke product-id waaraan deze inzending is gekoppeld
werkstroomstatus Voorwerp Dit is alleen beschikbaar bij het ophalen van details van een specifieke inzending. Dit object toont de status van de werkstroom voor deze inzending. Zie het werkstroomstatusobject voor meer informatie.
Verwijzingen reeks van objecten Raadpleeg het koppelingsobject voor meer informatie
commitStatus Zie Productinzendingen beheren voor meer informatie.
isExtensionInf Booleaan Geeft aan of de inzending een extensiestuurprogramma is
isUniversal Booleaan Geeft aan of de inzending de Universal API-test doorstaat. Een stuurprogramma is compatibel met DCHU als het declaratief en Universeel is
isDeclarativeInf Booleaan Geeft aan of de inzending de declaratieve INVerif-test doorstaat. Een driver is compatibel met DCHU als het declaratief en universeel is.
Naam touw De naam van de inzending.
Typologie touw Geeft aan of de inzending een initiële of afgeleide inzending is. Mogelijke waarden zijn:
  • initiaal
  • Afgeleid
Downloads Voorwerp Dit is alleen beschikbaar bij het ophalen van details van een specifieke inzending. Dit object toont de downloads die beschikbaar zijn voor de inzending. Zie downloadobject voor meer informatie.

Werkstroomstatusobject

Dit object vertegenwoordigt de status van de werkstroom voor een bepaalde entiteit

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

Dit object heeft de volgende waarden

Waarde Typologie Beschrijving
huidige stap touw De naam van de huidige stap in de algemene werkstroom voor deze entiteit.
Voor opname/pakketinzending zijn de mogelijke waarden (beschrijving tussen haakjes):
  • packageInfoValidation (metagegevens en inhoud van pakket valideren)
  • voorbereiding (Pakket voorbereiden voor verwerking)
  • scannen (pakketinhoud scannen op malware)
  • validatie (validatie van testresultaten)
  • catalogCreation (een beveiligingscatalogus voor pakket maken)
  • manualReview (handmatige beoordeling ondergaan)
  • ondertekenen (de binaire bestanden ondertekenen)
  • finalizeIngestion (de opname voltooien en ondertekende bestanden voorbereiden om te downloaden of publiceren)
Staat touw De status van de huidige stap. Mogelijke waarden zijn:
  • nietGestart
  • begonnen
  • mislukt
  • voltooid
Berichten array Een matrix met tekenreeksen voor berichten over de huidige stap (met name als er een fout opgetreden is)

Object downloaden

Dit object vertegenwoordigt de downloads voor een bepaalde inzending.

{
  "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": []
}

Dit object heeft de volgende waarden

Waarde Typologie Beschrijving
Artikelen array Een matrix met downloadtypen en de URL voor elk type.
Typologie touw Het type pakket dat kan worden gedownload. Mogelijke waarden zijn:
  • "initialPackage": pakket geüpload door gebruiker (voor een nieuwe inzending verwijst het naar de SAS-URI voor het uploaden van het pakket)
  • "derivedPackage": shell voor afgeleide inzendingen
  • "signedPackage" – pakket ondertekend door Microsoft
  • "certificationReport" - certificeringsrapport voor het ondertekende product
  • driverMetadata : koppeling verwijst naar een bestand waarmee metagegevens van stuurprogramma's kunnen worden gedownload. Zie metagegevens van stuurprogrammapakketten voor meer informatie.
  • ExternalNotes
  • Onbekend
Berichten array Een matrix met tekenreeksen voor berichten over de downloadbare bestanden

Dit object vertegenwoordigt een lijst met nuttige koppelingen voor de entiteit met daarin

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

Dit object heeft de volgende waarden

Waarde Typologie Beschrijving
Href Snaar / Touwtje De URL voor toegang tot de resource via API
Rel Snaar / Touwtje Type resource. Mogelijke waarden zijn:
  • zelf – Koppeling verwijst naar zichzelf
  • next_link: koppelingspunten naar de volgende resource die doorgaans wordt gebruikt voor paginering
  • get_submissions – koppelingspunten naar alle inzendingen van een product
  • commit_submission : koppelingspunten voor het doorvoeren van een inzending
  • update_submission : koppelingspunten voor het bijwerken van de inzending
  • update_shippinglabel : koppelingspunten voor het bijwerken van het verzendlabel
Methode Snaar / Touwtje Het type http-methode dat moet worden gebruikt bij het aanroepen van de URL. Mogelijke waarden zijn:
  • Ophalen
  • BERICHT
  • Patch

Extra kenmerkobject

Dit object biedt meer kenmerken over het product als het van het type RAID-controller, opslagcontroller of servervirtualisatievalidatieprogramma (SVVP) is. Het kan een van de drie typen objecten bevatten: StorageController, RaidController of SVVP.

StorageController-Object

Waarde Typologie Beschrijving
BIOS-versie touw ROM Bios-versie
firmwareversie touw Firmwareversie
stuurprogrammaVersie touw Stuurprogrammaversie
Bestuurdersnaam touw De naam van de bestuurder
apparaatversie touw Apparaatversie
chipsetName touw Naam van de chipset
gebruiktEigen merk booleaan Multi-pathing ondersteund via eigen stuurprogramma. Indien waar, dan zijn proprietaryName en proprietaryVersion verplicht.
merknaam touw Softwarenaam voor meerdere paden
eigen versie touw Softwareversie met meerdere paden
tweedehandsMicrosoft booleaan Microsoft MPIO wordt ondersteund via een apparaatspecifieke module. Indien waar, zijn microsoftName en microsoftVersion verplicht.
microsoftName touw Softwarenaam voor meerdere paden
microsoftVersion touw Softwareversie met meerdere paden
usedBootSupport booleaan Opstartondersteuning
gebruiktBeterBoot booleaan Boot > 2.2 TB-ondersteuning. Indien waar, dan zijn ondersteunde UEFI-versie en ondersteunde ACPI-versie verplicht
uefiVersion touw Ondersteunde UEFI-versie
acpiVersion touw Ondersteunde ACPI-versie
ondersteuntSector4K512E booleaan Ondersteuningssectorgrootte van 4K/512e
supportsSector4K4K booleaan Ondersteuningssectorgrootte van 4K/4K
ondersteuntDifferentiatie booleaan Differentieel (hoogspanningsverschil)

Raidcontrollerobject

Waarde Typologie Beschrijving
firmwareversie touw Firmwareversie
filterversie touw Stuurprogrammaversie
stuurprogrammaVersie touw Filterversie
gebruiktEigen merk booleaan Multi-pathing ondersteund via eigen stuurprogramma. Indien waar, dan zijn proprietaryName en proprietaryVersion verplicht
merknaam touw Softwarenaam voor meerdere paden
eigen versie touw Softwareversie met meerdere paden
tweedehandsMicrosoft booleaan Microsoft MPIO wordt ondersteund via een apparaatspecifieke module. Indien waar, dan zijn microsoftName en microsoftVersion verplicht
microsoftName touw Softwarenaam voor meerdere paden
microsoftVersion touw Softwareversie met meerdere paden
DerdePartijNodig booleaan Niet-Microsoft-stuurprogramma dat nodig is voor connectiviteit
isSES booleaan SES (SCSI-behuizingsdiensten) Geeft aan of een SES is opgenomen. SCSI is de standaardterm voor een servicebus die apparaten op een systeem verbindt, oorspronkelijk Small Computer System Interface. SES is een afkorting voor SCSI Enclosure Services.
isSAFTE booleaan SAF-TE (ANBll-specificatie). Geeft aan of een SAF-TE is opgenomen. ANBll een branchespecificatie. SAF-TE is een afkorting voor SCSI Toegangs Fouttolerante Behuizingen. SCSI is de standaardterm voor een servicebus die apparaten op een systeem verbindt, oorspronkelijk Small Computer System Interface.
aanvullende informatie touw Aanvullende informatie

SVVP-object

Waarde Typologie Beschrijving
productversie touw Productversie
supportLink touw Ondersteunings-URL
guestOs touw Gastbesturingssysteem. Mogelijke waarden zijn:
  • Windows Server 2008
  • Windows Server 2008 Release 2
  • Windows Server 2012
  • Windows Server 2012 R2
processorarchitectuur touw Hardwareprocessorarchitectuur. Mogelijke waarden zijn:
  • Xeon
  • Opteron
  • Itanium 2
maxProcessors geheel getal Maximum aantal processors in VM
MaximaalGeheugen geheel getal Maximaal geheugen in VM (in GB)

Lijst met producttypen

Een product kan van de volgende typen zijn. Samen met het besturingssysteem wordt deze informatie gebruikt om de toepasbaarheid te identificeren.

  • 3D-printer
  • Versnellingsmetersensor
  • Alles in één
  • Alles-in-één met touchscreen
  • Audioapparaat
  • Audioverwerkingsobjecten
  • Bluetooth-controller
  • Bluetooth controller zonder USB
  • Camera
  • Camerasensor
  • groepering
  • Compute Accelerator MCDM 2.7
  • Compute Accelerator MCDM 3.1
  • Compute Accelerator MCDM 3.2
  • Converteerbare tablet
  • Bureaublad
  • Digitale Media Renderer
  • Digital Media Server
  • Digitale stilstaande camera's
  • Digitale videocamera's
  • Apparaten met distributiescanbeheer
  • WSD-printer met meerdere functies
  • Vingerafdruklezer
  • Gamecontroller
  • Algemene controller
  • Algemeen draagbaar apparaat
  • Grafische adapter MCDM2.7
  • Grafische adapter MCDM2.8
  • Grafische adapter MCDM2.9
  • Grafische adapter MCDM3.0
  • Grafische adapter WDDM1.0
  • Grafische adapter WDDM1.1
  • Grafische adapter WDDM1.2
  • Grafische adapter WDDM1.2 DisplayOnly
  • Grafische adapter WDDM1.2 RenderOnly
  • Grafische adapter WDDM1.3
  • Grafische Adapter WDDM1.3 DisplayOnly
  • Grafische adapter WDDM1.3 RenderOnly
  • Grafische adapter WDDM2.0
  • Grafische adapter alleen voor WDDM2.0-weergave
  • Grafische Adapter WDDM2.0 Render-Only
  • Grafische adapter WDDM2.1
  • Grafische kaart met alleen WDDM2.1-weergave
  • WDDM2.1 render-only grafische adapter
  • Grafische adapter WDDM2.2
  • Alleen WDDM2.2-grafische adapter voor weergave
  • Render-only grafische adapter WDDM2.2
  • Grafische adapter WDDM2.3
  • Grafische adapter WDDM2.3 alleen-weergave
  • Alleen weergeven van grafische adapter WDDM2.3
  • Grafische adapter WDDM2.4
  • WDDM2.4-graphicsadapter alleen voor weergave
  • Grafische adapter alleen voor rendering WDDM2.4
  • Grafische adapter WDDM2.4 VM
  • Grafische adapter WDDM2.5
  • Grafische adapter WDDM2.5 Display-alleen
  • WDDM2.5 Grafische Adapter alleen renderen
  • Grafische adapter WDDM2.5 VM
  • Grafische adapter WDDM2.6
  • Grafische adapter WDDM2.6 alleen weergave
  • Grafische adapter WDDM2.6 alleen voor rendering
  • Grafische adapter WDDM2.6 VM
  • Grafische adapter WDDM2.7
  • Alleen grafische adapter WDDM2.7-weergave
  • WDDM2.7 Grafische Adapter voor Alleen Renderen
  • Grafische adapter WDDM2.7 VM
  • Grafische adapter WDDM2.8
  • Alleen grafische adapter WDDM2.8-weergave
  • Alleen grafische adapter WDDM2.8-weergave
  • Grafische adapter WDDM2.8 VM
  • Grafische adapter WDDM2.9
  • Grafische adapter alleen weergave WDDM2.9
  • Grafische adapter alleen voor WDDM2.9-rendering
  • Grafische adapter WDDM2.9 VM
  • Grafische adapter WDDM3.0
  • Alleen grafische adapter WDDM3.0-weergave
  • Grafische adapter alleen voor weergave WDDM3.0
  • Grafische adapter WDDM3.0 VM
  • Grafische adapter WDDM3.1
  • Alleen weergeven van grafische adapter WDDM3.1
  • Grafische adapter WDDM3.1 alleen voor weergaven
  • Grafische adapter WDDM3.1 VM
  • Grafische adapter WDDM3.2
  • WDDM3.2-alleen-voor-weergave grafische adapter
  • Alleen grafische adapter WDDM3.2 renderen
  • Grafische adapter WDDM3.2 VM
  • Grafische tablet
  • Gyroscoopsensor
  • Harde schijf
  • Hardwaretransformaties voor multifunctioneel gebruik
  • Toetsenbord
  • Schakelapparaat voor toetsenbord, video en muis
  • LAN
  • LAN (server)
  • LAN CS
  • Virtuele LAN-machine (server)
  • Laptop
  • Laptop met Touchscreen
  • LCD
  • Lichtsensor
  • Locatiesensor
  • Media Player
  • Mobiel breedband CDMA
  • Mobiele breedband gsm
  • Mobiele telefoon
  • Beeldscherm
  • Moederbord
  • Bewegingssensorfusie
  • Printer met meerdere functies
  • Nabij veldnabijheid
  • Netwerkmediaapparaat
  • NFC
  • NFC Smart Card Reader
  • Optische drive
  • Pen digitaliseren
  • Tekening aanwijzen
  • PrecisionTouchpad
  • Aanwezigheidssensor
  • Printer
  • Projector
  • Verwisselbare opslag
  • Router
  • Scanner
  • SDIO Controller
  • Serverapparaat
  • Validatieprogramma voor servervirtualisatie
  • Elektronische handtekeningtablet
  • Smartcards
  • Smartcardlezer
  • Opslagmatrix
  • Opslagcontroller
  • Opslagruimenadapter
  • Opslagruimte-schijf
  • Tablet
  • Aanraken
  • Aanraakscherm
  • TPM20
  • Ultra-Mobile pc
  • Ultra-Mobile pc met Aanraak
  • USB-controller
  • USB-hub
  • Webcam
  • WLAN
  • WLAN CSB
  • WSD Multifunctionele Printer
  • WSD-printer
  • WSD-scanner

Lijst met familiecodes van het besturingssysteem

De volgende tabel bevat Family Codes van het besturingssysteem en de bijbehorende beschrijvingen.

Familiecode van het besturingssysteem Beschrijving
WindowsMe Windows Me
Windows2000 Windows 2000
Windows98 Vensters 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 Windows Server-oplossingen
Windows8 Windows 8
Windows8Server Windows Server 2012
Windows81 Windows 8.1
Windows81Server Windows Server 2012 R2
Windows_v100 Drempelwaarde voor Windows 10
Windows_v100Server Drempelwaarde voor Windows Server
Windows_v100_RS1 Windows 10 Jubileum Update
Windows_v100Server_RS1 Windows Server 2016
Windows_v100_RS2 Windows 10 RS2-update
Windows_v100Server_RS2 Windows Server RS2
Windows_v100_RS3 Windows 10 RS3-update
Windows_v100Server_RS3 Windows Server RS3
Windows_v100_RS4 Windows 10 RS4-update
Windows_v100Server_RS5 Windows Server 2019
Windows_v100_RS5 Windows 10 RS5 x86
Windows_v100_RS5 Windows 10 RS5 x64
Windows_v100_19H1 Windows 10 19H1-bijwerking
Windows_v100_VB Windows 10 versie 2004
Windows_v100Server_FE Windows - Server, versie 21H2
Windows_v100_CO Windows - Client, versie 21H2
Windows_v100_NI Windows 11 Client, versie 22H2
Windows_v100_GE Windows 11 Client, versie 24H2
Windows_v100Server_GE Windows Server 2025
Windows_v100_25H2 Windows 11 Client, versie 25H2
Windows_v100_26H1 Windows 11 Client, versie 26H1

Lijst met besturingssysteemcodes

De volgende tabel bevat besturingssysteemcodes en de bijbehorende beschrijvingen.

Besturingssysteemcode Beschrijving
WINDOWS_ME Windows Me
WINDOWS_98 Vensters 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 Windows 7 Client
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 Windows 8 Client
WINDOWS_8_X64 Windows 8 Client x64
WINDOWS_8_ARM Windows 8 Client RT
WINDOWS_8_SERVER_X64 Windows Server 2012
WINDOWS_v63 Windows 8.1 Client
WINDOWS_v63_X64 Windows 8.1 Client x64
WINDOWS_v63_ARM Windows 8.1 Client RT
WINDOWS_v63_SERVER_X64 Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL Windows 10 Client-versies 1506 en 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL Windows 10 Client-versies 1506 en 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL Windows 10 Client-versies 1506 en 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL Windows 10 Client-versies 1506 en 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL Windows 10 Client versie 1607
WINDOWS_v100_X64_RS1_FULL Windows 10 Client versie 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 versie 2004 Client x86
WINDOWS_v100_X64_VB_FULL Windows-versie 2004 Client x64
WINDOWS_v100_ARM64_VB_FULL Windows-versie 2004 Client Arm64
WINDOWS_v100_SERVER_X64_FE_FULL Windows - Server, versie 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL Windows - Server, versie 21H2 Arm64
WINDOWS_v100_X64_CO_FULL Windows - Client, versie 21H2 x64
WINDOWS_v100_ARM64_CO_FULL Windows - Client, versie 21H2 Arm64
WINDOWS_v100_X64_NI_FULL Windows 11 Client, versie 22H2 x64
WINDOWS_v100_ARM64_NI_FULL Windows 11 Client, versie 22H2 Arm64
WINDOWS_v100_X64_GE_FULL Windows 11 Client, versie 24H2 x64
WINDOWS_v100_ARM64_GE_FULL Windows 11 Client, versie 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL Windows Server 2025 ARM64
WINDOWS_v100_X64_25H2_FULL Windows 11 Client, versie 25H2 x64
WINDOWS_v100_ARM64_25H2_FULL Windows 11 Client, versie 25H2 ARM64
WINDOWS_v100_ARM64_26H1_FULL Windows 11 Client, versie 26H1 ARM64

Foutcodes

De foutcodes zijn van toepassing op alle webmethoden van de API. Als de aanvraag niet kan worden voltooid, bevat het antwoord een van de volgende HTTP-foutcodes.

HTTP-status Beschrijving
400 – Foute aanvraag Aanvraag is niet goed opgemaakt (bijvoorbeeld ongeldige aanvraagsyntaxis, ongeldige aanvraaglijsten of misleidende aanvraagroutering)
401 - Niet geautoriseerd Authenticatie is mislukt of niet opgegeven
403 - Verboden Toegang tot een resource is verboden.
404 – Niet gevonden De aangevraagde entiteit is niet gevonden.
415 - Niet-ondersteund mediatype Payload heeft een indeling die niet wordt ondersteund door deze methode op de doelresource.
422 - Niet-verwerkte entiteit Validatiefouten.
429 - Te veel aanvragen Er worden te veel aanvragen verzonden. Oproepen worden beperkt en de uitsteltijd wordt opgegeven in het antwoord.
500 - Interne Serverfout Er is een onherstelbare fout opgetreden op de API-server.

Als er functionele validatiefouten zijn, bevat de hoofdtekst van het antwoord een van de volgende functionele foutcodes.

Foutcode Foutmelding Beschrijving
OngeldigeInvoer Geretourneerd wanneer een invoervalidatie mislukt.
VerzoekOngeldigVoorHuidigeStatus Alleen in behandeling zijnde inzendingen kunnen worden doorgevoerd Wordt geretourneerd wanneer een vastlegging wordt toegepast op een inzending die niet in afwachting is.
VerzoekOngeldigVoorHuidigeStatus Eerste inzending bestaat al Wordt geretourneerd wanneer een initiële inzending wordt gemaakt voor een stuurprogramma dat al een initiële inzending heeft.
VerzoekOngeldigVoorHuidigeStatus Kan geen afgeleide inzending maken omdat er geen initiële inzending is gemaakt Geretourneerd wanneer een afgeleide inzending wordt gemaakt voor een stuurprogramma dat geen initiële inzending heeft.
UpdateNietToegestaan Niet gemachtigd om het product bij te werken Gerapporteerd bij het proberen bij te werken van een product dat is gedeeld (doorverkocht), aangezien gedeelde producten niet kunnen worden bijgewerkt.
UpdateNietToegestaan Kan product niet bijwerken zonder initiële inzending Geretourneerd wanneer geprobeerd wordt een product bij te werken dat nog geen initiële inzending heeft.
UpdateNietToegestaan Kan product niet bijwerken omdat de werkstroom is mislukt Geretourneerd bij het bijwerken van een product met een mislukte werkstroom.
UpdateNietToegestaan Aankondigingsdatum kan niet worden bijgewerkt nadat het opnameproces is voltooid Geretourneerd wanneer de publicatiedatum wordt bijgewerkt nadat de verwerking is voltooid.
UpdateNietToegestaan Productnaam kan momenteel niet worden bijgewerkt. Probeer het opnieuw.
UpdateNietToegestaan Niet gemachtigd om de inzending bij te werken Geretourneerd bij het bijwerken van een inzending voor een product dat is gedeeld (doorverkocht) omdat gedeelde producten niet kunnen worden bijgewerkt.
UpdateNietToegestaan Kan de inzending niet bijwerken omdat de werkstromen zijn mislukt Geretourneerd bij het proberen te updaten van een inzending met een niet-geslaagde workflow.
EntiteitNietGevonden Er is geen inzending gevonden Teruggestuurd wanneer geprobeerd wordt een inzending in te dienen die niet bestaat.
EntiteitNietGevonden Product is niet gevonden Aangegeven wanneer geprobeerd wordt een inzending te maken waarvoor geen product bestaat.
OngeldigeInvoer Extensiestuurprogramma's moeten worden gepubliceerd als automatische update. Er moet één van isAutoInstallDuringOSUpgrade of isAutoInstallOnApplicableSystems waar zijn. Wordt geretourneerd wanneer een verzendlabel voor Windows-updates voor een extensie INF wordt gemaakt zonder te kiezen voor IsAutoInstallDuringOSUpgrade of isAutoInstallOnApplicableSystems.
OngeldigeInvoer CHID's zijn alleen toegestaan wanneer HardwareIds voor besturingssystemen Windows 10 en hoger zijn. Wordt geretourneerd als een verzendlabel dat bedoeld is voor een besturingssysteem ouder dan Windows 10, wordt gemaakt met CHID-doel. CHID-targeting is alleen van toepassing voor Windows 10 en hoger.
OngeldigeInvoer Het verzendlabel kan niet worden bijgewerkt wanneer er een andere werkstroom wordt uitgevoerd. Probeer het opnieuw. Wordt geretourneerd wanneer een verzendlabel wordt bijgewerkt terwijl een eerder proces nog wordt uitgevoerd.
VerzoekOngeldigVoorHuidigeStatus Kan geen verzendlabel voor publicatie maken voor Postvak IN of voor een systeemtype. Eén kan het verzendlabel alleen delen. Wordt teruggestuurd wanneer het verzendlabel van Windows Update is aangemaakt op een inbox-stuurprogramma of een systeem.
VerzoekOngeldigVoorHuidigeStatus De inzending is nog niet gereed om een verzendlabel aan te maken. Probeer het na enige tijd opnieuw. Wordt geretourneerd wanneer een verzendlabel wordt aangemaakt zonder te wachten tot de voorbereiding of voorverwerking is voltooid.

Zie ook