Freigeben über

Produktdaten abrufen

  • Artikel

Verwenden Sie die folgenden Methoden in Microsoft-Hardware-APIs , um Daten für Hardwareprodukte abzurufen, die für Ihr 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.

Method URI Beschreibung
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/ Abrufen von Daten für alle Ihre Produkte
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID} Abrufen von Daten für ein bestimmtes Produkt
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions Abrufen von Daten für alle Übermittlungen eines Produkts
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions/{submissionId} Abrufen von Daten für eine bestimmte Übermittlung eines Produkts

Voraussetzungen

Falls noch nicht geschehen, führen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs aus, bevor Sie versuchen, eine dieser Methoden zu verwenden.

Datenressourcen

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

Produktressource

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/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/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 Details finden Sie im Linkobjekt .
isCommitted Boolean Gibt an, ob das Produkt über mindestens eine zugesicherte Übermittlung verfügt.
isExtensionInf Boolean (VERALTET) Gibt an, ob das Produkt ein Erweiterungstreiber ist. Dieses Feld ist veraltet und sollte nicht mehr verwendet werden. isExtensionInf wurde in die Eigenschaft auf Übermittlungsebene verschoben.
deviceMetadataIds Array von GUIDs GUIDs, die Gerätemetadatenübermittlungen dem Treiber zuordnen
deviceType String Gibt den Gerätetyp an. Dabei sind folgende Werte möglich:
  • "intern" – Eine interne Komponente, das Gerät ist Teil eines Systems und verbindet innerhalb des PCs
  • "extern" – Ein externes Gerät 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 Boolean Gibt an, ob das Produkt ein signierter Testtreiber ist. Weitere Informationen zu Testsignaturtreiberpaketen finden Sie unter WHQL Test Signature Program
isFlightSign Boolean Gibt an, ob es sich bei dem Produkt um einen flugsignierten Fahrer handelt. 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 sich für das Windows-Insider-Programm registriert haben. 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
productName String Der Name des Treibers, wie während der Erstellung angegeben
selectedProductTypes dictionary Schlüsselwertpaar, bei dem beide Zeichenfolgen sind.
requestedSignatures Zeichenfolgen-Arrays Liste der Betriebssystemsignaturen, für die das Produkt zertifiziert ist. Eine Liste aller Betriebssysteme finden Sie in der Liste der Betriebssystemcodes.
additionalAttributes Objekt Weitere Details finden Sie im Zusätzlichen Attribute-Objekt .
testHarness Zeichenfolge Der Typ des Pakets, das übermittelt wurde. Mögliche Werte sind
  • hlk
  • hck
  • attestation
  • notset
announcementDate datetime Das Datum, an dem das Produkt im Windows Server-Katalog enthalten sein wird

Übermittlungsressource

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 long Die ID der Übermittlung
Productid lang Die private Produkt-ID, der diese Übermittlung zugeordnet ist
Workflowstatus 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 Details finden Sie im Workflowstatusobjekt.
Verknüpfungen Array von Objekten Weitere Details finden Sie im Linkobjekt .
commitStatus Weitere Informationen finden Sie unter "Produktübermittlungen verwalten".
isExtensionInf Boolean Gibt an, ob es sich bei der Übermittlung um einen Erweiterungstreiber handelt.
isUniversal Boolean Gibt an, ob die Übermittlung den Universellen API-Test bestanden hat. Ein Treiber ist DCHU-kompatibel, wenn er decalarativ und universal ist
isDeclarativeInf Boolean Gibt an, ob die Übermittlung den Deklarativen INVerif-Test bestanden hat. Ein Treiber ist DCHU-kompatibel, wenn er decalarativ und universal ist
Name Zeichenfolge Der Name der Übermittlung
type 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 Details finden Sie im 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
currentStep Zeichenfolge Der Name des aktuellen Schritts im gesamten Workflow für diese Entität.
Für die Erfassung/Paketübermittlung sind die möglichen Werte (Beschreibung in Klammern):
  • packageInfoValidation (Validating Package metadata and contents)
  • Vorbereitung (Vorbereiten des Pakets für die Verarbeitung)
  • Scannen (Scannen von Paketinhalten für Schadsoftware)
  • Validierung (Validierung von Testergebnissen)
  • catalogCreation (Erstellen eines Sicherheitskatalogs für das Paket)
  • manualReview (durch manuelle Überprüfung)
  • Signieren (Signieren der Binärdateien)
  • finalizeIngestion (Abschließen der Aufnahme und Abrufen signierter Dateien zum Herunterladen oder Veröffentlichen)
Status Zeichenfolge Der Status des aktuellen Schritts. Dabei sind folgende Werte möglich:
  • notStarted
  • gestartet
  • „Fehlgeschlagen“
  • abgeschlossen
Nachrichten array Ein Zeichenfolgen-Array, um Nachrichten über den aktuellen Schritt zu liefern (insbesondere im Falle eines Fehlers)

Download-Objekt

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

{
  "items": [
    {
      "type": "initialPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/dc55b8c6-a01c-40b6-b815-cac8bc08812a?sv=2016-05-31&sr=b&sig=ipjW3RsVC75lZrcEZRh9JmTX89L4gTIKkxwqv9F8Axs%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "type": "derivedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/6bd77dbf-a851-46d2-b703-29ea4efae006?sv=2016-05-31&sr=b&sig=O5XQf%2FzMbI2FFt5WwSUJWL1JbWY4JXXPRkCKAnX7IRs%3D&se=2018-03-12T15:32:10Z&sp=rl&rscd=attachment%3B filename%3DShell_1152921504621441930.hlkx"
    },
    {
      "type": "signedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/0b83a294-c1d1-4136-82a1-dd52f51841e3?sv=2016-05-31&sr=b&sig=zTfxKJmaTwpbFol%2FpAKG0QuXJTTxm5aZ0F2wQQI8whc%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "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. Details hierzu finden Sie weiter unten.
type Zeichenfolge Der Pakettyp, der zum Download verfügbar ist. Dabei sind folgende Werte möglich:
  • "initialPackage" – Vom Benutzer hochgeladenes Paket (bei einer neuen Ü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 in den Treiberpaketmetadaten.
  • 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 String Die URL für den Zugriff auf die Ressource über die API
Rel String Der Typ der Ressource. Dabei sind folgende Werte möglich:
  • selbst – 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 Einreichungen 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 String Typ der http-Methode, die beim Aufrufen der URL verwendet werden soll. Mögliche Werte:
  • GET
  • POST
  • PATCH

Zusätzliches Attributobjekt

Dieses Objekt stellt zusätzliche Attribute für das Produkt bereit, wenn es sich um den Typ RAID-Controller, Speichercontroller oder Server Virtualization Validation Program (SVVP) handelt. Sie kann einen von drei Objekttypen enthalten: StorageController, RaidController oder SVVP.

StorageController-Objekt

Wert Typ Beschreibung
biosVersion Zeichenfolge ROM Bios-Version
firmwareVersion Zeichenfolge Firmware Version
driverVersion Zeichenfolge Treiberversion
driverName Zeichenfolge Treibername
deviceVersion Zeichenfolge Geräteversion
chipsatzName Zeichenfolge Chipsatzname
usedProprietary boolean Multi-Pathing wird über proprietäre Treiber unterstützt. If true, then proprietaryName and proprietaryVersion are madatory
proprietaryName Zeichenfolge Softwarename für mehrere Pfade
proprietaryVersion Zeichenfolge Multipfad-Softwareversion
usedMicrosoft boolean Microsoft MPIO wird über gerätespezifisches Modul unterstützt. Wenn wahr, dann sind microsoftName und microsoftVersion madatory
microsoftName Zeichenfolge Softwarename für mehrere Pfade
microsoftVersion Zeichenfolge Multipfad-Softwareversion
usedBootSupport boolean Startunterstützung
usedBetterBoot boolean Boot >2.2TB-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 boolean Unterstützungssektorgröße von 4K/512e
supportsSector4K4K boolean Unterstützungssektorgröße von 4K/4K
supportsDifferential boolean Differenzial (Hochspannungsdifferenzial)

RaidController-Objekt

Wert Typ Beschreibung
firmwareVersion Zeichenfolge Firmware Version
filterVersion Zeichenfolge Treiberversion
driverVersion Zeichenfolge Filterversion
usedProprietary boolean Multi-Pathing wird über proprietäre Treiber unterstützt. Wenn wahr, sind proprietäreName und proprietäreVersion obligatorisch.
proprietaryName Zeichenfolge Softwarename für mehrere Pfade
proprietaryVersion Zeichenfolge Multipfad-Softwareversion
usedMicrosoft boolean Microsoft MPIO wird über gerätespezifisches Modul unterstützt. Wenn "true", sind "microsoftName" und "microsoftVersion" obligatorisch.
microsoftName Zeichenfolge Softwarename für mehrere Pfade
microsoftVersion Zeichenfolge Multipfad-Softwareversion
isThirdPartyNeeded boolean Nicht-Microsoft-Treiber von Drittanbietern, der für die Konnektivität erforderlich ist
isSES boolean 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 boolean SAF-TE (ANBll Specification). 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".
additionalInfo Zeichenfolge Zusatzinformationen

SVVP-Objekt

Wert Typ Beschreibung
productVersion 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
processorArchitecture Zeichenfolge Hardwareprozessorarchitektur. Dabei sind folgende Werte möglich:
  • Xeon
  • Opteron
  • Itanium 2
maxProcessors integer Max. Prozessoren in VM
maxMemory integer Max. Arbeitsspeicher in VM (in GB)

Liste der Produkttypen

Ein Produkt kann von den folgenden Typen sein. Diese Informationen werden zusammen mit dem Betriebssystem verwendet, um die Anwendbarkeit zu identifizieren.

  • 3D-Drucker
  • Beschleunigungssensor
  • All-in-One
  • Alles in einem mit Toucheingabe
  • Audiogerät
  • Audioverarbeitungsobjekte
  • Bluetooth-Controller
  • Bluetooth-Controller ohne USB
  • Kamera
  • Kamerasensor
  • Cluster
  • Compute Accelerator MCDM 2.7
  • Compute Accelerator MCDM 3.1
  • Compute Accelerator MCDM 3.2
  • Wandelbares Tablet
  • Desktop
  • Renderer für digitale Medien
  • Digitaler Medienserver
  • Digitale Standbildkameras
  • Digitale Videokameras
  • Verteilungsscanverwaltung aktivierte Geräte
  • Enterprise WSD Multi-Function Printer
  • 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
  • Graphics Adapter WDDM1.2
  • Graphics Adapter WDDM1.2 DisplayOnly
  • Grafikadapter WDDM1.2 RenderOnly
  • Graphics Adapter WDDM1.3
  • Graphics Adapter WDDM1.3 DisplayOnly
  • Graphics Adapter WDDM1.3 RenderOnly
  • Graphics Adapter WDDM2.0
  • Nur Grafikadapter WDDM2.0 anzeigen
  • Nur Grafikadapter WDDM2.0 rendern
  • Grafikadapter WDDM2.1
  • Nur Grafikkarte WDDM2.1-Anzeige
  • Nur Grafikadapter WDDM2.1 rendern
  • Grafikadapter WDDM2.2
  • Nur Grafikkarte WDDM2.2-Anzeige
  • Nur Grafikadapter WDDM2.2 rendern
  • Grafikadapter WDDM2.3
  • Nur Grafikkarte WDDM2.3-Anzeige
  • Nur Grafikadapter WDDM2.3 rendern
  • Grafikadapter WDDM2.4
  • Nur Grafikadapter WDDM2.4 anzeigen
  • Nur Grafikadapter WDDM2.4 rendern
  • Grafikadapter WDDM2.4 VM
  • Grafikadapter WDDM2.5
  • Nur Grafikkarte WDDM2.5-Anzeige
  • Nur Grafikadapter WDDM2.5 rendern
  • Grafikkarte WDDM2.5 VM
  • Grafikadapter WDDM2.6
  • Nur Grafikkarte WDDM2.6-Anzeige
  • Nur Grafikadapter WDDM2.6 rendern
  • GRAFIKKARTE WDDM2.6 VM
  • Grafikadapter WDDM2.7
  • Nur Grafikkarte WDDM2.7-Anzeige
  • Nur Grafikadapter WDDM2.7 rendern
  • Grafikkarte WDDM2.7 VM
  • Grafikkarte WDDM2.8
  • Nur Grafikkarte WDDM2.8-Anzeige
  • Nur Grafikadapter WDDM2.8 rendern
  • Grafikkarte WDDM2.8 VM
  • Grafikadapter WDDM2.9
  • Nur Grafikadapter WDDM2.9 anzeigen
  • Nur Grafikadapter WDDM2.9 rendern
  • Grafikkarte WDDM2.9 VM
  • Grafikadapter WDDM3.0
  • Nur Grafikadapter WDDM3.0 anzeigen
  • Nur Grafikadapter WDDM3.0 rendern
  • Grafikkarte WDDM3.0 VM
  • Grafikadapter WDDM3.1
  • Nur Grafikkarte WDDM3.1-Anzeige
  • Nur Grafikadapter WDDM3.1 rendern
  • Grafikadapter WDDM3.1 VM
  • Grafikadapter WDDM3.2
  • Nur Grafikadapter WDDM3.2-Anzeige
  • Nur Grafikadapter WDDM3.2 rendern
  • 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
  • Monitor
  • Hauptplatine
  • Bewegungssensor-Fusion
  • Multifunktionsdrucker
  • Nahfeldnähe
  • Netzwerkmediengerät
  • NFC
  • NFC-Smartcardleser
  • Optisches Laufwerk
  • Stift-Digitalisierer
  • Zeigende Zeichnung
  • Präzisionstouchpad
  • Anwesenheitssensor
  • Printer
  • Projector
  • 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
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 Threshold
Windows_v100_RS1 Windows 10 Anniversary 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 – 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 der Betriebssystemcodes

In der folgenden Tabelle sind Betriebssystemcodes 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_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-Clientversionen 1506 und 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL Windows 10-Clientversionen 1506 und 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL Windows 10-Clientversionen 1506 und 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL Windows 10-Clientversionen 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, 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 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 Anforderung nicht wohlgeformt (z. B. falsch formatierte Anforderungssyntax, ungültige Anforderungsrahmen oder betrügerisches Anforderungsrouting)
401 – Nicht autorisiert Fehler bei der Authentifizierung oder nicht angegeben
403 – Unzulässig Verboten für den Zugriff auf eine Ressource
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 – Nicht verarbeitete Entität Überprüfungsfehler.
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
InvalidInput Wird zurückgegeben, wenn eine Eingabeüberprüfung fehlschlägt
RequestInvalidForCurrentState 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.
RequestInvalidForCurrentState Die erste Übermittlung ist bereits vorhanden. Wird zurückgegeben, wenn eine anfängliche Übermittlung für einen Treiber erstellt wird, der bereits über eine erste Übermittlung verfügt.
RequestInvalidForCurrentState 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 keine anfängliche Übermittlung hat.
UpdateUnauthorized Nicht autorisiert, das Produkt zu aktualisieren Wird zurückgegeben, wenn versucht wird, ein freigegebenes Produkt zu aktualisieren (weiterverkauft), da freigegebene Produkte nicht aktualisiert werden können.
UpdateUnauthorized Produkt kann nicht ohne anfängliche Übermittlung aktualisiert werden Wird zurückgegeben, wenn versucht wird, ein Produkt zu aktualisieren, das nicht über eine erste Übermittlung verfügt
UpdateUnauthorized Produkt kann nicht aktualisiert werden, da der Workflow fehlgeschlagen ist. Wird zurückgegeben, wenn versucht wird, ein Produkt zu aktualisieren, das über einen fehlgeschlagenen Workflow verfügt
UpdateUnauthorized Ankündigungsdatum kann nach Abschluss des Aufnahmevorgangs nicht aktualisiert werden Zurückgegeben, wenn das Ankündigungsdatum nach Abschluss der Aufnahme aktualisiert wird
UpdateUnauthorized Der Produktname kann zurzeit nicht aktualisiert werden. Versuchen Sie es erneut.
UpdateUnauthorized Nicht berechtigt, die Übermittlung zu aktualisieren Wird zurückgegeben, wenn versucht wird, eine Übermittlung für ein freigegebenes Produkt (weiterverkauft) zu aktualisieren, da freigegebene Produkte nicht aktualisiert werden können.
UpdateUnauthorized 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
EntityNotFound Produkt nicht gefunden Beim Versuch, eine Übermittlung zu erstellen, für die kein Produkt vorhanden ist, wird zurückgegeben.
InvalidInput Erweiterungstreiber müssen als automatisches Update veröffentlicht werden. Entweder isAutoInstallDuringOSUpgrade oder isAutoInstallOnApplicableSystems muss "true" sein. Wird zurückgegeben, wenn eine Windows Update-Versandbezeichnung für eine Erweiterung INF erstellt wird, ohne "IsAutoInstallDuringOSUpgrade" oder "isAutoInstallOnApplicableSystems" auszuwählen.
InvalidInput Chids sind nur zulässig, wenn HardwareIds für Betriebssysteme Windows10 & Above gelten. Wird zurückgegeben, wenn ein Versandetikett für Betriebssystemen unter Windows 10 mit CHID-Ziel erstellt wird. CHID-Zielbestimmung gilt nur für Windows 10 und höher.
InvalidInput Das Versandetikett kann nicht aktualisiert werden, wenn ein anderer Workflow ausgeführt wird. Versuchen Sie es noch mal. Wird zurückgegeben, wenn ein Versandetikett aktualisiert wird, wenn ein vorheriger Workflow noch ausgeführt wird.
RequestInvalidForCurrentState Veröffentlichungsversandbezeichnung für Posteingang oder Systemtyp kann nicht erstellt werden. Man kann das Versandetikett nur teilen. Wird zurückgegeben, wenn windows update Versandbezeichnung auf einem Posteingangstreiber oder einem System erstellt wird.
RequestInvalidForCurrentState Die Übermittlung ist noch nicht zum Erstellen eines Versandetiketts bereit. Versuchen Sie es später noch einmal. Wird zurückgegeben, wenn ein Versandetikett erstellt wird, ohne darauf zu warten, dass die Vorbereitung oder vor der Verarbeitung abgeschlossen ist.

Weitere Informationen