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. 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 Produktanträge zu erstellen oder zu verwalten, sehen Sie sich die Methoden in "Produktübermittlungen verwalten" an.

Voraussetzungen

Erfüllen 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.

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/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.

Einreichungsressource

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:

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

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"
    },
    {
      "type": "unreferencedFilesReport",
      "url": "<SAS URL from Hardware API>"
    }
  ],
  "messages": []
}

Dieses Objekt hat die folgenden Werte

Link-Objekt

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

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

RaidController-Objekt

SVVP-Objekt

Liste der Produkttypen

Ein Produkt kann 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
• All-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 Nur zum Rendern
• Grafikadapter WDDM2.2
• Grafikadapter WDDM2.2 Display Only
• Render-Only-Grafikadapter WDDM2.2
• Grafikadapter WDDM2.3
• Grafikkarte WDDM2.3 Nur Anzeige
• Grafikadapter WDDM2.3 Render-Only
• Grafikadapter WDDM2.4
• Grafikkartenadapter WDDM2.4 Display Only
• Grafikadapter WDDM2.4 RenderOnly
• Grafikadapter WDDM2.4 VM
• Grafikadapter WDDM2.5
• Grafikkartenadapter WDDM2.5 Nur Anzeige
• Grafikadapter WDDM2.5 Render-Only
• Grafikadapter WDDM2.5 VM
• Grafikadapter WDDM2.6
• Grafikadapter WDDM2.6 Display Only
• 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 Nur Anzeige
• Grafikadapter WDDM2.8 RenderOnly
• Grafikkarten-Adapter WDDM2.8 VM
• Grafikadapter WDDM2.9
• Grafikkartenadapter WDDM2.9 Display Only
• 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
• Grafikkarte WDDM3.1 Nur Anzeige
• Grafikadapter WDDM3.1 RenderOnly
• Grafikadapter WDDM3.1 VM
• Grafikadapter WDDM3.2
• Grafikkartenadapter WDDM3.2 Nur-Anzeige
• 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
• Wechselbarer Speicher
• Router
• Scanner
• SDIO-Controller
• Server
• Validierungsprogramm für Servervirtualisierung
• Signaturtablet
• Chipkarten
• Chipkartenleser
• Speicherarray
• Speichercontroller
• Speicherplatzadapter
• Speicherplatzlaufwerk
• Tablet
• Toucheingabe
• Touch-Monitor
• TPM20
• Ultra-mobiler 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.

Liste der Betriebssystemcodes

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

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.

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

Siehe auch

• Hardware-Dashboard-API-Beispiele (GitHub)