Freigeben über

Produktdaten abrufen

Verwenden Sie die folgenden Methoden in Microsoft-Hardware-APIs, um Daten für Hardwareprodukte abzurufen, die in Ihrem Dev Center-Konto registriert sind. Eine Einführung in Microsoft-Hardware-APIs, einschließlich der Voraussetzungen für die Verwendung der API, finden Sie unter Verwalten von Hardware-Übermittlungen mithilfe von APIs.

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

Bevor Sie diese Methoden verwenden können, muss das Produkt bereits in Ihrem Dev Center-Konto vorhanden sein. Um Produktübermittlungen zu erstellen oder zu verwalten, lesen Sie die Methoden in Produktübermittlungen verwalten.

Methode URI (Uniform Resource Identifier) Beschreibung
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ Abrufen von Daten für alle Ihre Produkte
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Abrufen der Daten für ein bestimmtes Produkt
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions Abrufen von Daten für alle Übermittlungen eines Produkts
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Abrufen von Daten für eine bestimmte Übermittlung eines Produkts

Voraussetzungen

Vervollständigen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs, bevor Sie versuchen, eine dieser Methoden zu verwenden.

Datenressourcen

Die Methoden der Microsoft Hardware-APIs zum Abrufen von Produktdaten verwenden die folgenden JSON-Datenressourcen.

Product-Ressource

Diese Ressource stellt ein Hardwareprodukt (Treiber) dar, das für Ihr Konto registriert ist.

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

Diese Ressource hat die folgenden Werte.

Wert Typ Beschreibung
Id Lang Die private Produkt-ID des Produkts
sharedProductId Lang Die freigegebene Produkt-ID des Produkts
Verknüpfungen Array von Objekten Weitere Informationen finden Sie unter Linkobjekt.
verpflichtet Boolescher Typ (Boolean) Gibt an, ob das Produkt über mindestens eine zugesicherte Übermittlung verfügt.
isExtensionInf Boolescher Typ (Boolean) (VERALTET) Gibt an, ob das Produkt ein Erweiterungstreiber ist. Dieses Feld ist veraltet und sollte nicht mehr verwendet werden. isExtensionInf wurde zu einer Eigenschaft auf Übermittlungsebene verschoben.
Geräte-Metadaten-IDs Array von GUIDs GUIDs, die Gerätemetadatenübermittlungen dem Treiber zuordnen
Gerätetyp Schnur Gibt den Typ des Geräts an. Dabei sind folgende Werte möglich:
  • „intern“ – Eine interne Komponente, ein Gerät ist Teil eines Systems und stellt eine Verbindung im PC her
  • „extern“ – Eine externe Komponente ist ein externes Gerät (Peripheriegerät), das eine Verbindung mit einem PC herstellt.
  • „internalExternal“ – Beide Geräte können intern (innerhalb eines PCs) und extern (Peripheriegerät) verbunden werden.
  • „notSet“ – keine Daten verfügbar
isTestSign Boolescher Typ (Boolean) Gibt an, ob das Produkt ein signierter Testtreiber ist. Weitere Informationen zum Testen von Treiberpaketen finden Sie unter WHQL-Testsignaturprogramm.
isFlightSign Boolescher Typ (Boolean) Gibt an, ob das Produkt ein Flight-signierter Treiber ist. Flight-signierte Treiber sind Testtreiber, die über Windows Update veröffentlicht werden können. Sie können nur auf Computern veröffentlicht/installiert werden, die für das Windows-Insider-Programm registriert sind. Sie können auf Computern installiert werden, ohne den sicheren Start zu deaktivieren. Sie können nicht auf Einzelhandelscomputern installiert werden, die nicht Teil des Windows-Insider-Programms sind.
marketingNames Zeichenfolgen-Arrays Marketingnamen oder Aliase des Produkts
Produktname Schnur Der Name des Treibers, wie während der Erstellung angegeben
ausgewählteProdukttypen Wörterbuch Schlüssel-Wert-Paar, bei dem es sich bei beiden um Zeichenfolgen handelt.
  • Der Schlüssel stellt den Betriebssystemfamiliencode dar. Eine Liste der Betriebssystemfamiliencodes finden Sie in der Liste der Betriebssystemfamiliencodes.
  • Der Wert stellt den Typ des Produkts dar. Eine Liste der Produkttypen finden Sie unter Produkttypen.
angeforderte Signaturen Zeichenfolgen-Arrays Liste der Betriebssystemsignaturen, für die das Produkt zertifiziert ist. Eine Liste aller Betriebssysteme finden Sie in der Liste der Betriebssystemcodes.
zusätzlicheAttribute Objekt Weitere Informationen finden Sie unter Zusätzliches Attributobjekt.
testHarness Zeichenfolge Der Typ des übermittelten Pakets. Mögliche Werte sind:
  • hlk
  • hck
  • Bescheinigung
  • notset
Ankündigungsdatum Datum/Uhrzeit Das Datum, an dem das Produkt im Windows Server-Katalog enthalten ist.

Submission-Ressource

Diese Ressource stellt eine Übermittlung eines Produkts dar.

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

Diese Ressource hat die folgenden Werte:

Wert Typ Beschreibung
Id lang Die ID der Übermittlung
Produkt-ID lang Die private Produkt-ID, mit der diese Übermittlung verknüpft ist
Arbeitsablaufstatus Objekt Dies ist nur beim Abrufen von Details einer bestimmten Übermittlung verfügbar. Dieses Objekt stellt den Status des Workflows für diese Übermittlung dar. Weitere Informationen finden Sie unter Workflowstatusobjekt.
Verknüpfungen Array von Objekten Weitere Informationen finden Sie unter Linkobjekt.
commitStatus Weitere Informationen finden Sie unter Produktübermittlungen verwalten.
isExtensionInf Boolescher Typ (Boolean) Gibt an, ob es sich bei der Übermittlung um einen Erweiterungstreiber handelt.
istUniversell Boolescher Typ (Boolean) Gibt an, ob die Übermittlung den universellen API-Test bestanden hat. Ein Treiber ist DCHU-kompatibel, wenn er deklarativ und universell ist
isDeklarativInf Boolescher Typ (Boolean) Gibt an, ob die Übermittlung den deklarativen INVerif-Test bestanden hat. Ein Treiber ist DCHU-kompatibel, wenn er deklarativ und universell ist.
Name Zeichenfolge Der Name der Übermittlung.
Typ Zeichenfolge Gibt an, ob es sich bei der Übermittlung um eine anfängliche oder abgeleitete Übermittlung handelt. Mögliche Werte sind:
  • Initial
  • Abgeleitet
Downloads Objekt Dies ist nur beim Abrufen von Details einer bestimmten Übermittlung verfügbar. Dieses Objekt stellt die Downloads dar, die für die Übermittlung verfügbar sind. Weitere Informationen finden Sie unter Downloadobjekt.

Workflowstatus-Objekt

Dieses Objekt stellt den Status des Workflows für eine bestimmte Entität dar.

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

Dieses Objekt hat die folgenden Werte

Wert Typ Beschreibung
aktueller Schritt Zeichenfolge Der Name des aktuellen Schritts im gesamten Workflow für diese Entität.
Für die Erfassung/Paketübermittlung sind dies die möglichen Werte (Beschreibung in Klammern):
  • packageInfoValidation (Validieren von Paketmetadaten und -inhalten)
  • preparation (Vorbereitung des Pakets auf die Verarbeitung)
  • scanning (Scannen von Paketinhalten für Schadsoftware)
  • validation (Validierung von Testergebnissen)
  • catalogCreation (Erstellen eines Sicherheitskatalogs für das Paket)
  • manualReview (Durchlaufen der manuellen Überprüfung)
  • signing (Signieren der Binärdateien)
  • finalizeIngestion (Abschließen der Erfassung und Abrufen signierter Dateien zum Herunterladen oder Veröffentlichen)
Status Zeichenfolge Der Status des aktuellen Schritts. Dabei sind folgende Werte möglich:
  • nicht begonnen
  • gestartet
  • „Fehlgeschlagen“
  • abgeschlossen
Nachrichten Array Ein Zeichenfolgen-Array, um Nachrichten über den aktuellen Schritt bereitzustellen (insbesondere im Falle eines Fehlers)

Download-Objekt

Dieses Objekt stellt die Downloads für eine bestimmte Übermittlung dar.

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

Dieses Objekt hat die folgenden Werte

Wert Typ Beschreibung
Elemente Array Ein Array von Downloadtypen und die URL für die einzelnen Typen.
Typ Zeichenfolge Der Typ des zum Download verfügbaren Pakets. Dabei sind folgende Werte möglich:
  • „initialPackage“ – Vom Benutzer hochgeladenes Paket (für eine neue Übermittlung verweist es auf den SAS-URI zum Hochladen des Pakets)
  • „derivedPackage“ – Shell für abgeleitete Übermittlungen
  • „signedPackage“ – von Microsoft signiertes Paket
  • „certificationReport“ – Zertifizierungsbericht für das signierte Produkt
  • driverMetadata – Link verweist auf eine Datei, die das Herunterladen von Treibermetadaten ermöglicht. Weitere Informationen finden Sie unter Treiber-Paket-Metadaten.
  • ExternalNotes
  • Unbekannt
Nachrichten Array Ein Array von Zeichenfolgen zum Bereitstellen von Nachrichten über die herunterladbaren Dateien

Dieses Objekt stellt eine Liste hilfreicher Links für die enthaltende Entität dar.

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

Dieses Objekt hat die folgenden Werte

Wert Typ Beschreibung
Href Schnur Die URL für den Zugriff auf die Ressource über die API
Rel Schnur Der Typ der Ressource. Dabei sind folgende Werte möglich:
  • self – Link verweist auf sich selbst
  • next_link – Verknüpfungspunkte zu der nächsten Ressource, die in der Regel für die Paginierung verwendet wird
  • get_submissions – Link verweist auf alle Übermittlungen eines Produkts
  • commit_submission – Link verweist auf einen Commit einer Übermittlung
  • update_submission – Link verweist auf die Aktualisierung der Übermittlung
  • update_shippinglabel – Linkpunkte zum Aktualisieren des Versandetiketts
Methode Schnur Typ der http-Methode, die beim Aufrufen der URL verwendet werden soll. Mögliche Werte sind:
  • ERHALTEN/Bekommen
  • SENDEN
  • FLICKEN

Zusätzliches Attributobjekt

Dieses Objekt enthält weitere Attribute für das Produkt, wenn es sich um den Typ RAID-Controller, Speichercontroller oder das Server Virtualization Validation-Programm (SVVP) handelt. Es kann einen von drei Objekttypen enthalten: StorageController, RaidController oder SVVP.

StorageController-Objekt

Wert Typ Beschreibung
BIOS-Version Zeichenfolge ROM Bios-Version
firmwareVersion Zeichenfolge Firmwareversion
Treiberversion Zeichenfolge Treiberversion
Fahrername Zeichenfolge Treibername
Geräteversion Zeichenfolge Geräteversion
chipsatzName Zeichenfolge Chipsatzname
gebrauchtProprietär Boolescher Wert Multi-Pathing wird über proprietäre Treiber unterstützt. Wenn „true“, sind proprietaryName und proprietaryVersion obligatorisch.
Markenname Zeichenfolge Multipfad-Softwarename
proprietäreVersion Zeichenfolge Multipfad-Softwareversion
gebrauchte Microsoft-Produkte Boolescher Wert Microsoft MPIO wird über gerätespezifisches Modul unterstützt. Wenn „true“, sind microsoftName und microsoftVersion obligatorisch.
microsoftName Zeichenfolge Multipfad-Softwarename
MicrosoftVersion Zeichenfolge Multipfad-Softwareversion
usedBootSupport Boolescher Wert Startunterstützung
benutzterBessererStiefel Boolescher Wert Boot > 2.2-TB-Unterstützung. Wenn „true“, sind unterstützte UEFI-Version und unterstützte ACPI-Version obligatorisch.
uefiVersion Zeichenfolge Unterstützte UEFI-Version
acpiVersion Zeichenfolge Unterstützte ACPI-Version
supportsSector4K512E Boolescher Wert Unterstützungssektorgröße von 4K/512e
unterstütztSektor4K4K Boolescher Wert Unterstützungssektorgröße von 4K/4K
unterstütztDifferential Boolescher Wert Differenzial (Hochspannungsdifferenzial)

RaidController-Objekt

Wert Typ Beschreibung
firmwareVersion Zeichenfolge Firmware-Version
Filterversion Zeichenfolge Treiberversion
Treiberversion Zeichenfolge Filterversion
gebrauchtProprietär Boolescher Wert Multi-Pathing wird über proprietäre Treiber unterstützt. Wenn „true“, sind proprietaryName und proprietaryVersion obligatorisch.
Markenname Zeichenfolge Multipfad-Softwarename
proprietäreVersion Zeichenfolge Multipfad-Softwareversion
gebrauchtMicrosoft Boolescher Wert Microsoft MPIO wird über gerätespezifisches Modul unterstützt. Wenn „true“, sind microsoftName und microsoftVersion obligatorisch.
microsoftName Zeichenfolge Multipfad-Softwarename
Microsoft-Version Zeichenfolge Multipfad-Softwareversion
istDrittparteiErforderlich Boolescher Wert Nicht von Microsoft stammender Treiber für Konnektivität erforderlich
isSES Boolescher Wert SES (SCSI-Gehäusedienste). Gibt an, ob ein SES enthalten ist. SCSI ist der Standardbegriff für einen Servicebus, der Geräte auf einem System verbindet, ursprünglich Small Computer System Interface. SES ist kurz für SCSI-Gehäusedienste.
isSAFTE Boolescher Wert SAF-TE (ANBll-Spezifizierung). Gibt an, ob ein SAF-TE enthalten ist. ANBll, eine Branchenspezifikation. SAF-TE ist kurz für fehlertolerante SCSI-Gehäuse. SCSI ist der Standardbegriff für einen Servicebus, der Geräte auf einem System verbindet, ursprünglich Small Computer System Interface.
zusätzlicheInformationen Zeichenfolge Zusatzinformation

SVVP-Objekt

Wert Typ Beschreibung
Produktversion Zeichenfolge Produktversion
supportLink Zeichenfolge Support-URL
guestOs Zeichenfolge Gastbetriebssystem Dabei sind folgende Werte möglich:
  • Windows Server 2008
  • Windows Server 2008 Release 2
  • Windows Server 2012
  • Windows Server 2012 R2
Prozessorarchitektur Zeichenfolge Hardwareprozessorarchitektur. Dabei sind folgende Werte möglich:
  • Xeon
  • Opteron
  • Itanium 2
maxProcessors Integer Max. Prozessoren in VM
Maximaler Speicher Integer Max. Arbeitsspeicher in VM (in GB)

Liste der Produkttypen

Ein Produkt zu einem der folgenden Typen gehören. Zusammen mit dem Betriebssystem werden diese Informationen verwendet, um die Anwendbarkeit zu identifizieren.

  • 3D-Drucker
  • Beschleunigungssensor
  • All-in-One
  • Alle-In-One mit Touch
  • Audiogerät
  • Audioverarbeitungsobjekte
  • Bluetooth-Controller
  • Bluetooth-Controller ohne USB
  • Kamera
  • Kamerasensor
  • Kluster
  • Compute Accelerator MCDM 2.7
  • Compute Accelerator MCDM 3.1
  • Compute Accelerator MCDM 3.2
  • Wandelbares Tablet
  • Arbeitsfläche
  • Renderer für digitale Medien
  • Digitaler Medienserver
  • Digitale Standbildkameras
  • Digitale Videokameras
  • Für die Verteilungsscanverwaltung geeignete Geräte
  • Unternehmens-WSD-Multifunktionsdrucker
  • Fingerabdruckleser
  • Spielcontroller
  • Generischer Controller
  • Generisches tragbares Gerät
  • Grafikadapter MCDM2.7
  • Grafikadapter MCDM2.8
  • Grafikadapter MCDM2.9
  • Grafikadapter MCDM3.0
  • Grafikadapter WDDM1.0
  • Grafikadapter WDDM1.1
  • Grafikadapter WDDM1.2
  • Grafikadapter WDDM1.2 DisplayOnly
  • Grafikadapter WDDM1.2 RenderOnly
  • Grafikadapter WDDM1.3
  • Grafikkarte WDDM1.3 DisplayOnly
  • Grafikadapter WDDM1.3 RenderOnly
  • Grafikadapter WDDM2.0
  • Graphics Adapter WDDM2.0 DisplayOnly
  • Grafikadapter WDDM2.0 RenderOnly
  • Grafikadapter WDDM2.1
  • Graphics Adapter WDDM2.1 DisplayOnly
  • Grafikadapter WDDM2.1 RenderOnly
  • Grafikadapter WDDM2.2
  • Graphics Adapter WDDM2.2 DisplayOnly
  • Grafikadapter WDDM2.2 RenderOnly
  • Grafikadapter WDDM2.3
  • Graphics Adapter WDDM2.3 DisplayOnly
  • Grafikadapter WDDM2.3 RenderOnly
  • Grafikadapter WDDM2.4
  • Graphics Adapter WDDM2.4 DisplayOnly
  • Grafikadapter WDDM2.4 RenderOnly
  • Grafikadapter WDDM2.4 VM
  • Grafikadapter WDDM2.5
  • Graphics Adapter WDDM2.5 DisplayOnly
  • Grafikadapter WDDM2.5 RenderOnly
  • Grafikadapter WDDM2.5 VM
  • Grafikadapter WDDM2.6
  • Graphics Adapter WDDM2.6 DisplayOnly
  • Grafikadapter WDDM2.6 RenderOnly
  • Grafikkarte WDDM2.6 VM
  • Grafikadapter WDDM2.7
  • Graphics Adapter WDDM2.7 DisplayOnly
  • Grafikadapter WDDM2.7 RenderOnly
  • Grafikadapter WDDM2.7 VM
  • Grafikadapter WDDM2.8
  • Graphics Adapter WDDM2.8 DisplayOnly
  • Grafikadapter WDDM2.8 RenderOnly
  • Grafikkarten-Adapter WDDM2.8 VM
  • Grafikadapter WDDM2.9
  • Graphics Adapter WDDM2.9 DisplayOnly
  • Grafikadapter WDDM2.9 RenderOnly
  • Grafikadapter WDDM2.9 VM
  • Grafikadapter WDDM3.0
  • Graphics Adapter WDDM3.0 DisplayOnly
  • Grafikadapter WDDM3.0 RenderOnly
  • Grafikadapter WDDM3.0 VM
  • Grafikadapter WDDM3.1
  • Graphics Adapter WDDM3.1 DisplayOnly
  • Grafikadapter WDDM3.1 RenderOnly
  • Grafikadapter WDDM3.1 VM
  • Grafikadapter WDDM3.2
  • Graphics Adapter WDDM3.2 DisplayOnly
  • Grafikadapter WDDM3.2 RenderOnly
  • Grafikadapter WDDM3.2 VM
  • Grafik-Tablet
  • Gyroskop-Sensor
  • Festplatte
  • Hardware-Multifunktionstransformationen
  • Tastatur
  • Tastatur-Video-Maus-Schalter
  • LAN
  • LAN (Server)
  • LAN CS
  • Virtuelle LAN-Maschine (Server)
  • Laptop
  • Laptop mit Touch-Eingabe
  • LCD
  • Lichtsensor
  • Standortsensor
  • Media Player
  • Mobiles Breitband-CDMA
  • Mobiles Breitband-GSM
  • Mobiltelefon
  • Bildschirm
  • Hauptplatine
  • Bewegungssensor-Fusion
  • Multifunktionsdrucker
  • Nahfeldnähe
  • Netzwerkmediengerät
  • NFC
  • NFC-Smartcardleser
  • Optisches Laufwerk
  • Stift-Digitalisierer
  • Zeigende Zeichnung
  • Präzisionstouchpad
  • Anwesenheitssensor
  • Drucker
  • Projektor
  • Wechselmedien
  • Router
  • Scanner
  • SDIO-Controller
  • Server
  • Validierungsprogramm für Servervirtualisierung
  • Signatur-Tablet
  • Smartcards
  • Chipkartenleser
  • Speicherarray
  • Speichercontroller
  • Speicherplatzadapter
  • Speicherplatzlaufwerk
  • Tablet
  • Toucheingabe
  • Touch-Monitor
  • TPM20
  • Ultra-Mobile PC
  • Ultra-Mobile PC mit Touch-Eingabe
  • USB-Controller
  • USB-Hub
  • Webcam
  • WLAN
  • WLAN CSB
  • WSD-Multifunktionsdrucker
  • WSD-Drucker
  • WSD-Scanner

Liste der Betriebssystemfamiliencodes

In der folgenden Tabelle sind Betriebssystemfamiliencodes und deren Beschreibungen aufgeführt.

Betriebssystemfamiliencode Beschreibung
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 (Windows Heimserver)
Windows7 Windows 7
Windows2008ServerR2 Windows Server 2008 Release 2
WindowsServerSolutions Windows Server-Lösungen
Windows8 Windows 8
Windows8Server Windows Server 2012
Windows81 Windows 8,1
Windows81Server Windows Server 2012 R2
Windows_v100 Windows 10-Schwellenwert
Windows_v100Server Windows Server-Schwellenwert
Windows_v100_RS1 Windows 10 Jubiläums-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 Update
Windows_v100_VB Windows 10, Version 2004
Windows_v100Server_FE Windows – Server, Version 21H2
Windows_v100_CO Windows – Clientversion 21H2
Windows_v100_NI Windows 11-Clientversion 22H2
Windows_v100_GE Windows 11-Clientversion 24H2
Windows_v100Server_GE Windows Server 2025

Liste der Betriebssystemcodes

In der folgenden Tabelle sind Betriebssystemcodes s und deren Beschreibungen aufgeführt.

Betriebssystemcode Beschreibung
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 Heimserver)
WINDOWS_7 Windows 7-Client
WINDOWS_7_X64 Windows 7-Client x64
WINDOWS_2008_SERVER_R2_IA64 Windows Server 2008 Version 2 IA64
WINDOWS_2008_SERVER_R2_X64 Windows Server 2008 Version 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 Versionen 1506 und 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL Windows 10-Client Versionen 1506 und 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL (WINDOWS Version 100 Server X64 TH1 Vollversion) Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL Windows 10-Client Versionen 1506 und 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL Windows 10-Client Versionen 1506 und 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 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 Client x86
WINDOWS_v100_X64_VB_FULL Windows-Version 2004 Client x64
WINDOWS_v100_ARM64_VB_FULL Windows-Version 2004 Client Arm64
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

Fehlercodes

Die Fehlercodes gelten für alle Webmethoden der API. Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

HTTP-Status Beschreibung
400 – Ungültige Anforderung Die Anforderung ist nicht gut formuliert (z. B. fehlerhafte Anfragesyntax, ungültige Anfragenachrichtenstruktur oder irreführende Anfrageweiterleitung)
401 – Nicht autorisiert Fehler bei der Authentifizierung oder nicht angegeben
403 – Unzulässig Der Zugriff auf eine Ressource ist verboten.
404 – Nicht gefunden Die angeforderte Entität wurde nicht gefunden.
415 – Nicht unterstützter Medientyp Die Nutzlast wird in einem Format verwendet, das von dieser Methode für die Zielressource nicht unterstützt wird.
422 – Entität kann nicht verarbeitet werden Fehler bei der Überprüfung.
429 – Zu viele Anforderungen Zu viele Anforderungen werden gesendet. Anrufe werden gedrosselt, und die Backoffzeit wird in der Antwort bereitgestellt.
500 – Interner Serverfehler Auf dem API-Server ist ein nicht behebbarer Fehler aufgetreten.

Wenn funktionsbezogene Überprüfungsfehler auftreten, enthält der Antworttext einen der folgenden funktionalen Fehlercodes.

Fehlercode Fehlermeldung Beschreibung
Ungültige Eingabe Wird zurückgegeben, wenn eine Eingabeüberprüfung fehlschlägt.
AnfrageUngültigFürAktuellenStatus Es können nur ausstehende Übermittlungen zugesichert werden. Wird zurückgegeben, wenn ein Commit auf eine Übermittlung angewendet wird, die sich nicht im ausstehenden Zustand befindet.
AnforderungUngültigFürAktuellenZustand Die erste Übermittlung ist bereits vorhanden. Wird zurückgegeben, wenn eine anfängliche Übermittlung für einen Treiber erstellt wird, der bereits über eine anfängliche Übermittlung verfügt.
AnfrageUngültigFürAktuellenStatus Die abgeleitete Übermittlung kann nicht erstellt werden, da keine ursprüngliche Übermittlung erstellt wurde. Wird zurückgegeben, wenn eine abgeleitete Übermittlung für einen Treiber erstellt wird, der nicht über eine anfängliche Übermittlung verfügt.
Nicht autorisierte Aktualisierung Nicht autorisiert, das Produkt zu aktualisieren Wird zurückgegeben, wenn versucht wird, ein freigegebenes (weiterverkauftes) Produkt zu aktualisieren, da freigegebene Produkte nicht aktualisiert werden können.
Aktualisierung nicht autorisiert Das Produkt kann nicht ohne erste Übermittlung aktualisiert werden. Wird zurückgegeben, wenn Sie versuchen, ein Produkt zu aktualisieren, das nicht über eine anfängliche Übermittlung verfügt.
Aktualisierung nicht autorisiert Produkt kann nicht aktualisiert werden, da der Workflow fehlgeschlagen ist. Wird zurückgegeben, wenn versucht wird, ein Produkt zu aktualisieren, das einen fehlgeschlagenen Workflow aufweist.
AktualisierungNichtErlaubt Ankündigungsdatum kann nach Abschluss des Erfassungsprozesses nicht aktualisiert werden Wird zurückgegeben, wenn das Ankündigungsdatum nach Abschluss der Erfassung aktualisiert wird.
Update nicht autorisiert Der Produktname kann zurzeit nicht aktualisiert werden. Versuchen Sie es erneut.
UpdateNichtAutorisiert Nicht berechtigt, die Übermittlung zu aktualisieren Wird zurückgegeben, wenn versucht wird, eine Übermittlung für ein Produkt zu aktualisieren, das freigegeben (weiterverkauft) wurde, da freigegebene Produkte nicht aktualisiert werden können.
Aktualisierung nicht autorisiert Die Übermittlung kann nicht aktualisiert werden, da die Workflows fehlgeschlagen sind. Wird zurückgegeben, wenn versucht wird, eine Übermittlung zu aktualisieren, die einen fehlgeschlagenen Workflow aufweist.
EntityNotFound Keine Übermittlung gefunden Wird zurückgegeben, wenn versucht wird, einen Commit für eine Übermittlung vorzunehmen, die nicht vorhanden ist.
Entität nicht gefunden Produkt nicht gefunden Wird zurückgegeben, wenn Sie versuchen, eine Übermittlung zu erstellen, für die kein Produkt vorhanden ist.
Ungültige Eingabe Erweiterungstreiber müssen als automatisches Update veröffentlicht werden. Entweder isAutoInstallDuringOSUpgrade oder isAutoInstallOnApplicableSystems muss „true“ sein. Wird zurückgegeben, wenn ein Windows Update-Versandetikett für eine Erweiterung INF erstellt wird, ohne „isAutoInstallDuringOSUpgrade“ oder „isAutoInstallOnApplicableSystems“ auszuwählen.
Ungültige Eingabe CHIDs sind nur zulässig, wenn HardwareIds für Betriebssysteme unter Windows 10 und höher gelten. Wird zurückgegeben, wenn ein Versandetikett für Betriebssysteme unter Windows 10 mit CHID-Ziel erstellt wird. CHID-Zielbestimmung gilt nur für Windows 10 und höher.
Ungültige Eingabe Das Versandetikett kann nicht aktualisiert werden, wenn ein anderer Workflow ausgeführt wird. Versuchen Sie es erneut. Wird zurückgegeben, wenn ein Versandetikett aktualisiert wird, wenn ein vorheriger Workflow noch ausgeführt wird.
AnfrageFürAktuellenStatusUngültig Für den Posteingangs- oder Systemtyp kann kein Versandetikett zum Veröffentlichen erstellt werden. Das Versandetikett kann nur freigegeben werden. Wird zurückgegeben, wenn per Windows-Update ein Versandetikett auf einem Posteingangstreiber oder einem System erstellt wird.
AnfrageUngültigFürAktuellenZustand Die Übermittlung ist noch nicht zum Erstellen eines Versandetiketts bereit. Wiederholen Sie den Vorgang später. Wird zurückgegeben, wenn ein Versandetikett erstellt wird, ohne darauf zu warten, dass die Vorbereitung oder Vorverarbeitung abgeschlossen ist.

Siehe auch