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.

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.

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:

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"
    }
  ],
  "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 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
• 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
• Für die Verteilungsscanverwaltung geeignete Geräte
• Enterprise WSD Multi-Function Printer
• Fingerabdruckleser
• Spielcontroller
• Generischer Controller
• Generisches tragbares Gerät
• Graphics Adapter MCDM2.7
• Graphics Adapter MCDM2.8
• Graphics Adapter MCDM2.9
• Graphics Adapter 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
• Graphics Adapter WDDM2.0 DisplayOnly
• Grafikadapter WDDM2.0 RenderOnly
• Graphics Adapter WDDM2.1
• Graphics Adapter WDDM2.1 DisplayOnly
• Grafikadapter WDDM2.1 RenderOnly
• Graphics Adapter WDDM2.2
• Graphics Adapter WDDM2.2 DisplayOnly
• Grafikadapter WDDM2.2 RenderOnly
• Graphics Adapter WDDM2.3
• Graphics Adapter WDDM2.3 DisplayOnly
• Grafikadapter WDDM2.3 RenderOnly
• Graphics Adapter WDDM2.4
• Graphics Adapter WDDM2.4 DisplayOnly
• Grafikadapter WDDM2.4 RenderOnly
• Graphics Adapter WDDM2.4 VM
• Graphics Adapter WDDM2.5
• Graphics Adapter WDDM2.5 DisplayOnly
• Grafikadapter WDDM2.5 RenderOnly
• Graphics Adapter WDDM2.5 VM
• Graphics Adapter WDDM2.6
• Graphics Adapter WDDM2.6 DisplayOnly
• Grafikadapter WDDM2.6 RenderOnly
• Graphics Adapter WDDM2.6 VM
• Graphics Adapter WDDM2.7
• Graphics Adapter WDDM2.7 DisplayOnly
• Grafikadapter WDDM2.7 RenderOnly
• Graphics Adapter WDDM2.7 VM
• Graphics Adapter WDDM2.8
• Graphics Adapter WDDM2.8 DisplayOnly
• Grafikadapter WDDM2.8 RenderOnly
• Graphics Adapter WDDM2.8 VM
• Graphics Adapter WDDM2.9
• Graphics Adapter WDDM2.9 DisplayOnly
• Grafikadapter WDDM2.9 RenderOnly
• Graphics Adapter WDDM2.9 VM
• Graphics Adapter WDDM3.0
• Graphics Adapter WDDM3.0 DisplayOnly
• Grafikadapter WDDM3.0 RenderOnly
• Graphics Adapter WDDM3.0 VM
• Graphics Adapter WDDM3.1
• Graphics Adapter WDDM3.1 DisplayOnly
• Grafikadapter WDDM3.1 RenderOnly
• Graphics Adapter WDDM3.1 VM
• Graphics Adapter WDDM3.2
• Graphics Adapter WDDM3.2 DisplayOnly
• Grafikadapter WDDM3.2 RenderOnly
• Graphics Adapter 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.

Liste der Betriebssystemcodes

In der folgenden Tabelle sind Betriebssystemcodes s 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)