Obtención de datos de producto

Use los siguientes métodos de las API de hardware de Microsoft para recuperar datos de los productos de hardware registrados en su cuenta del Centro de desarrollo. Para ver una introducción a las API de hardware de Microsoft, incluidos los requisitos previos para usar la API, consulte Administrar envíos de hardware mediante API.

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

Para poder utilizar estos métodos, el producto deben existir ya en su cuenta del Centro de desarrollo. Para crear o administrar envíos para productos, consulte los métodos en Administrar envíos de productos.

Requisitos previos

Complete todos los requisitos previos de las API de hardware de Microsoft antes de intentar usar cualquiera de estos métodos.

Recursos de datos

Los métodos de las API de hardware de Microsoft para obtener datos del producto usan los siguientes recursos de datos JSON

Recurso de producto

Este recurso representa un producto de hardware (controlador) registrado en su cuenta.

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

Este recurso tiene los siguientes valores

Recurso de envío

Este recurso representa un envío de un producto.

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

Este recurso tiene los siguientes valores:

Objeto de estado de flujo de trabajo

Este objeto representa el estado del flujo de trabajo de una entidad determinada

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

Este objeto tiene los siguientes valores

Objeto de descarga

Este objeto representa las descargas de un envío determinado.

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

Este objeto tiene los siguientes valores

Objeto de vínculo

Este objeto representa una lista de vínculos útiles para la entidad contenedora

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

Este objeto tiene los siguientes valores

Objeto de atributo adicional

Este objeto proporciona más atributos sobre el producto si es de tipo controlador RAID, controlador de almacenamiento o programa de validación de virtualización de servidor (SVVP). Puede contener uno de los tres tipos de objetos: StorageController, RaidController o SVVP.

Objeto StorageController

Objeto RaidController

Objeto SVVP

Lista de tipos de productos

Un producto puede ser de los siguientes tipos. Junto con el sistema operativo, esta información se usa para identificar la aplicabilidad.

• Impresora 3D
• Sensor de aceleración
• Todo en uno
• Todo en uno con táctil
• Dispositivo de audio
• Objetos de procesamiento de datos
• Controlador Bluetooth
• Controlador Bluetooth no USB
• Cámara
• Sensor de cámara
• Clúster
• Acelerador de proceso MCDM 2.7
• Acelerador de proceso MCDM 3.1
• Acelerador de proceso MCDM 3.2
• Tableta convertible
• Escritorio
• Reproductor de medios digitales
• Servidor de medios digitales
• Cámaras digitales
• Videocámaras digitales
• Dispositivos habilitados para la administración de análisis de distribución
• Impresora multifunción WSD de empresa
• Lector de huellas dactilares
• Controlador de juego
• Controlador genérico
• Dispositivo portátil genérico
• Adaptador de gráficos MCDM2.7
• Adaptador de gráficos MCDM2.8
• Adaptador de gráficos MCDM2.9
• Adaptador de gráficos MCDM3.0
• Adaptador de gráficos WDDM1.0
• Adaptador de gráficos WDDM1.1
• Adaptador de gráficos WDDM1.2
• Adaptador de gráficos WDDM1.2 DisplayOnly
• Adaptador de gráficos WDDM1.2 RenderOnly
• Adaptador de gráficos WDDM1.3
• Adaptador de gráficos WDDM1.3 DisplayOnly
• Adaptador de gráficos WDDM1.3 RenderOnly
• Adaptador de gráficos WDDM2.0
• Adaptador de gráficos WDDM2.0 Display Only
• Adaptador de gráficos WDDM2.0 Render Only
• Adaptador de gráficos WDDM2.1
• Adaptador de gráficos WDDM2.1 Display Only
• Adaptador de gráficos WDDM2.1 Render Only
• Adaptador de gráficos WDDM2.2
• Adaptador de gráficos WDDM2.2 Display Only
• Adaptador de gráficos WDDM2.2 Render Only
• Adaptador de gráficos WDDM2.3
• Adaptador de gráficos WDDM2.3 Display Only
• Adaptador de gráficos WDDM2.3 Render Only
• Adaptador de gráficos WDDM2.4
• Adaptador de gráficos WDDM2.4 Display Only
• Adaptador de gráficos WDDM2.4 Render Only
• Adaptador de gráficos WDDM2.4 VM
• Adaptador de gráficos WDDM2.5
• Adaptador de gráficos WDDM2.5 Display Only
• Adaptador de gráficos WDDM2.5 Render Only
• Adaptador de gráficos WDDM2.5 VM
• Adaptador de gráficos WDDM2.6
• Adaptador de gráficos WDDM2.6 Display Only
• Adaptador de gráficos WDDM2.6 Render Only
• Adaptador de gráficos WDDM2.6 VM
• Adaptador de gráficos WDDM2.7
• Adaptador de gráficos WDDM2.7 Display Only
• Adaptador de gráficos WDDM2.7 Render Only
• Adaptador de gráficos WDDM2.7 VM
• Adaptador de gráficos WDDM2.8
• Adaptador de gráficos WDDM2.8 Display Only
• Adaptador de gráficos WDDM2.8 Render Only
• Adaptador de gráficos WDDM2.8 VM
• Adaptador de gráficos WDDM2.9
• Adaptador de gráficos WDDM2.9 Display Only
• Adaptador de gráficos WDDM2.9 Render Only
• Adaptador de gráficos WDDM2.9 VM
• Adaptador de gráficos WDDM3.0
• Adaptador de gráficos WDDM3.0 Display Only
• Adaptador de gráficos WDDM3.0 Render Only
• Adaptador de gráficos WDDM3.0 VM
• Adaptador de gráficos WDDM3.1
• Adaptador de gráficos WDDM3.1 Display Only
• Adaptador de gráficos WDDM3.1 Render Only
• Adaptador de gráficos WDDM3.1 VM
• Adaptador de gráficos WDDM3.2
• Adaptador de gráficos WDDM3.2 Display Only
• Adaptador de gráficos WDDM3.2 Render Only
• Adaptador de gráficos WDDM3.2 VM
• Tableta digitalizadora
• Sensor de giroscopio
• Disco duro
• Transformaciones multifunción de hardware
• Teclado
• Teclado, vídeo, mouse, selector
• LAN (Red de Área Local)
• LAN (servidor)
• LAN CS
• Máquina virtual LAN (servidor)
• Ordenador portátil
• Portátil con táctil
• LCD (Pantalla de Cristal Líquido)
• Sensor de luz
• Sensor de ubicación
• Reproductor multimedia
• CDMA de banda ancha móvil
• GSM de banda ancha móvil
• Teléfono móvil
• Supervisión
• Placa base
• Fusión del sensor de movimiento
• Impresora multifunción
• Proximidad de campo cercano
• Dispositivo multimedia de red
• NFC
• Lector de tarjeta inteligente NFC
• Unidad óptica
• Digitalizador de lápiz
• Dibujo que apunta
• Panel táctilde precisión
• Sensor de presencia
• Impresora
• Proyector
• Almacenamiento extraíble
• Enrutador
• Escáner
• Controlador SDIO
• Servidor
• Programa de validación de virtualización de servidor
• Tableta de firma
• Tarjetas inteligentes
• Lector de tarjeta inteligente
• Matriz de almacenamiento
• Controlador de almacenamiento
• Adaptador de espacios de almacenamiento
• Unidad de espacios de almacenamiento
• Tableta
• Tocar
• Monitor táctil
• TPM20
• Equipo ultramóvil
• Equipo ultramóvil con táctil
• Controladora USB
• Concentrador USB
• WebCam
• WLAN
• CSB WLAN
• Impresora multifunción WSD
• Impresora WSD
• Escáner de etiquetas WSD

Lista de códigos de familia del sistema operativo

En la tabla siguiente se enumeran los códigos de familia del sistema operativo y sus descripciones.

Lista de códigos de sistema operativo

En la tabla siguiente se enumeran los códigos de sistema operativo y sus descripciones.

Códigos de error

Los códigos de error son aplicables a todos los métodos web de la API. Si la solicitud no se puede completar correctamente, la respuesta contiene uno de los siguientes códigos de error HTTP.

Si hay errores de validación funcional, el cuerpo de la respuesta contiene uno de los siguientes códigos de error funcionales.

Consulte también

• Ejemplos de API del panel de hardware (GitHub)