Obtención de datos de producto

Artículo
10/04/2024

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.

Método	URI	Descripción
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/`	Obtener datos para todos los productos
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}`	Obtener datos para un producto específico
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions`	Obtener datos para todos los envíos de un producto
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}`	Obtener datos para un envío específico de un producto

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

Valor	Tipo	Descripción
Identificador	Largo	ID del producto privado del producto
sharedProductId	Largo	ID del producto compartido del producto
Vínculos	matriz de objetos	Para obtener más información, consulte el objeto de vínculo.
isCommitted	Booleano	Indica si el producto tiene al menos un envío confirmado.
isExtensionInf	Booleano	(EN DESUSO) Indica si el producto es un controlador de extensión. Este campo está obsoleto y no se debe utilizar. isExtensionInf se movió a una propiedad de nivel de envío.
deviceMetadataIds	matriz de GUID	GUID que asignan envíos de metadatos de dispositivo al controlador
deviceType	Cadena	Indica el tipo de dispositivo. Los valores posibles son: "internal": un componente interno, el dispositivo forma parte de un sistema y se conecta dentro del equipo "external": un componente externo, el dispositivo es un dispositivo externo (periférico) que se conecta a un equipo. "internalExternal": ambos, el dispositivo se puede conectar internamente (dentro de un equipo) y externamente (periféricos) "notSet": no hay datos disponibles
isTestSign	Booleano	Indica si el producto es un controlador firmado de prueba. Para obtener más información sobre los paquetes de controladores con firma de prueba, consulte Programa de firma de prueba de WHQL
isFlightSign	Booleano	Indica si el producto es un controlador firmado de lanzamiento como paquete piloto. Los controladores firmados de lanzamiento como paquete piloto son controladores de prueba que se pueden publicar a través de Windows Update. Solo se pueden publicar o instalar en máquinas suscritas al Programa Windows Insider. Se pueden instalar en máquinas sin deshabilitar el arranque seguro. No se pueden instalar en máquinas comerciales que no forman parte del Programa Windows Insider.
marketingNames	Matriz de cadenas	Nombres de marketing o alias del producto
productName	Cadena	Nombre del controlador tal y como se especifica durante la creación
selectedProductTypes	diccionario	Par clave-valor donde ambos son cadenas. Key representa el código de familia del sistema operativo. Para obtener una lista de códigos de familia del sistema operativo, consulte la lista de códigos de familia del sistema operativo. Value representa el tipo de producto. Para obtener una lista de tipos de productos, consulte tipos de productos.
requestedSignatures	Matriz de cadenas	Lista de firmas de sistema operativo para las que el producto está certificado. Para obtener una lista de todos los sistemas operativos, consulte la lista de códigos del sistema operativo.
additionalAttributes	Object	Para obtener más información, consulte el objeto de atributos adicionales.
testHarness	string	Tipo de paquete enviado. Los valores posibles son: hlk hck attestation notset
announcementDate	datetime	Fecha en que el producto se incluye en el catálogo de Windows Server.

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:

Valor	Tipo	Descripción
Identificador	long	Identificador del envío
Productid	long	ID de producto privado al que está asociad este envío
workflowstatus	objeto	Solo está disponible cuando se recuperan detalles de un envío específico. Este objeto muestra el estado del flujo de trabajo para este envío. Para obtener más información, consulte objeto de estado de flujo de trabajo.
Vínculos	matriz de objetos	Para obtener más información, consulte el objeto de vínculo.
commitStatus	Consulte Administración de envíos de productos para obtener más detalles.
isExtensionInf	Booleano	Indica si el envío es un controlador de extensión.
isUniversal	Booleano	Indica si el envío supera la prueba de API universal. Un controlador es compatible con DCHU si es Declarativo y Universal
isDeclarativeInf	Booleano	Indica si el envío supera la prueba declarativa INVerif. Un controlador es compatible con DCHU si es Declarativo y Universal.
Nombre	string	Nombre del envío.
Tipo	cadena	Indica si el envío es un inicial o derivado. Los valores posibles son: initial derivadas
Descargas	objeto	Solo está disponible cuando se recuperan detalles de un envío específico. Este objeto muestra las descargas disponibles para el envío. Para obtener más información, consulte objeto de descarga.

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

Valor	Tipo	Descripción
currentStep	string	Nombre del paso actual en el flujo de trabajo general de esta entidad. Para el envío de la ingesta o paquete, los valores posibles son (descripción entre paréntesis): packageInfoValidation (validación de los metadatos y el contenido del paquete) preparation (preparación del paquete para el procesamiento) scanning (análisis del contenido del paquete en busca de malware) validation (validación de resultados de las pruebas) catalogCreation (creación de un catálogo de seguridad para el paquete) manualReview (en proceso de revisión manual) signing (firma de los archivos binarios) finalizeIngestion (finalización de la ingesta y obtención de archivos firmados listos para descargar o publicar)
Valor	string	El estado del paso actual. Los valores posibles son: notStarted iniciado con errores completada
Mensajes	array	Una matriz de cadenas para proporcionar mensajes sobre el paso actual (especialmente en caso de error)

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

Valor	Tipo	Descripción
Productos	array	Matriz de tipos de descarga y la dirección URL de cada uno.
Tipo	cadena	Tipo de paquete disponible para descarga. Los valores posibles son: "initialPackage": paquete cargado por el usuario (para un nuevo envío, apunta al URI de SAS para cargar el paquete). "derivedPackage": shell para envíos derivados "signedPackage": paquete firmado por Microsoft "certificationReport": informe de certificación para el producto firmado driverMetadata: el vínculo apunta a un archivo que permite descargar los metadatos del controlador. Para obtener más información, consulte metadatos del paquete de controladores. ExternalNotes Unknown
Mensajes	array	Matriz de cadenas para proporcionar mensajes sobre los archivos descargables

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

Valor	Tipo	Descripción
Href	Cadena	Dirección URL para acceder al recurso a través de la API
Rel	Cadena	Tipo de recurso. Los valores posibles son: self: el vínculo apunta a sí mismo next_link: el vínculo apunta al siguiente recurso que se usa normalmente para la paginación. get_submissions: el vínculo apunta a todos los envíos de un producto commit_submission: el vínculo apunta para confirmar un envío update_submission: el vínculo apunta para actualizar el envío update_shippinglabel: el vínculo apunta para actualizar la etiqueta de envío
Método	Cadena	Tipo del método http que se va a usar al invocar la dirección URL. Los valores posibles son: GET PUBLICAR PATCH

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

Valor	Tipo	Descripción
biosVersion	string	Versión del BIOS de ROM
firmwareVersion	string	Versión de firmware
driverVersion	string	Versión del controlador
driverName	string	Nombre del controlador
deviceVersion	string	Versión del dispositivo
chipsetName	string	Nombre del conjunto de chips
usedProprietary	boolean	Varias rutas de acceso admitidas a través del controlador propietario. Si es true, proprietaryName y proprietaryVersion son obligatorios.
proprietaryName	string	Nombre de software de varias rutas de acceso
proprietaryVersion	string	Versión de software de varias rutas de acceso
usedMicrosoft	boolean	Microsoft MPIO se admite a través del módulo específico del dispositivo. Si es true, microsoftName y microsoftVersion son obligatorios.
microsoftName	string	Nombre de software de varias rutas de acceso
microsoftVersion	string	Versión de software de varias rutas de acceso
usedBootSupport	boolean	Compatibilidad con arranque
usedBetterBoot	boolean	Compatibilidad con arranque > de 2,2 TB. Si es true, la versión de UEFI admitida y la versión de ACPI admitida son obligatorias.
uefiVersion	string	Versión de UEFI compatible
acpiVersion	string	Versión de ACPI compatible
supportsSector4K512E	boolean	Admite un tamaño de sector de 4K/512e
supportsSector4K4K	boolean	Admite un tamaño de sector de 4K/4K
supportsDifferential	boolean	Diferencial (diferencial de alto voltaje)

Objeto RaidController

Valor	Tipo	Descripción
firmwareVersion	string	Versión de firmware
filterVersion	string	Versión del controlador
driverVersion	string	Versión de filtro
usedProprietary	boolean	Varias rutas de acceso admitidas a través del controlador propietario. Si es true, proprietaryName y proprietaryVersion son obligatorios
proprietaryName	string	Nombre de software de varias rutas de acceso
proprietaryVersion	string	Versión de software de varias rutas de acceso
usedMicrosoft	boolean	Microsoft MPIO se admite a través del módulo específico del dispositivo. Si es true, microsoftName y microsoftVersion son obligatorios
microsoftName	string	Nombre de software de varias rutas de acceso
microsoftVersion	string	Versión de software de varias rutas de acceso
isThirdPartyNeeded	boolean	Controlador que no es de Microsoft necesario para la conectividad
isSES	boolean	SES (SCSI Enclosure Services). Indica si se incluye un SES. SCSI es el término estándar para un bus de servicio que conecta dispositivos en un sistema, originalmente una interfaz de sistema de equipo pequeño. SES es la versión abreviada de SCSI Enclosure Services.
isSAFTE	boolean	SAF-TE (Especificación ANBll). Indica si se incluye un SAF-TE. ANBll es una especificación del sector. SAF-TE es la versión abreviada para SCSI Accessed Fault Tolerant Enclosures. SCSI es el término estándar para un bus de servicio que conecta dispositivos en un sistema, originalmente una interfaz de sistema de equipo pequeño.
additionalInfo	string	Información adicional

Objeto SVVP

Valor	Tipo	Descripción
productVersion	string	Versión del producto
supportLink	string	Dirección URL de soporte técnico
guestOs	string	SO invitado. Los valores posibles son: Windows Server 2008 Windows Server 2008 versión 2 Windows Server 2012 Windows Server 2012 R2
processorArchitecture	string	Arquitectura del procesador de hardware. Los valores posibles son: Xeon Opteron Itanium 2
maxProcessors	integer	Número máximo de procesadores en máquinas virtuales
maxMemory	integer	Memoria máxima en la máquina virtual (en GB)

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
Camera
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
LAN (servidor)
LAN CS
Máquina virtual LAN (servidor)
Laptop
Portátil con táctil
LCD
Sensor de luz
Sensor de ubicación
Media Player
CDMA de banda ancha móvil
GSM de banda ancha móvil
Teléfono móvil
Monitor
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
Server
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.

Código de familia del sistema operativo	Descripción
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 versión 2
WindowsServerSolutions	Soluciones de Windows Server
Windows8	Windows 8
Windows8Server	Windows Server 2012
Windows81	Windows 8.1
Windows81Server	Windows Server 2012 R2
Windows_v100	Windows 10 Threshold
Windows_v100Server	Windows Server Threshold
Windows_v100_RS1	Actualización de aniversario de Windows 10
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 versión 2004
Windows_v100Server_FE	Windows - Server, versión 21H2
Windows_v100_CO	Windows - Cliente, versión 21H2
Windows_v100_NI	Cliente Windows 11, versión 22H2
Windows_v100_GE	Cliente Windows 11, versión 24H2
Windows_v100Server_GE	Windows Server 2025

Lista de códigos de sistema operativo

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

Código del sistema operativo	Descripción
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	Cliente Windows Vista
WINDOWS_VISTA_X64	Cliente Windows Vista 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	Cliente de Windows 7
WINDOWS_7_X64	Cliente Windows 7 x64
WINDOWS_2008_SERVER_R2_IA64	Windows Server 2008 versión 2 IA64
WINDOWS_2008_SERVER_R2_X64	Windows Server 2008 versión 2 x64
WINDOWS_SERVER_SOLUTIONS_X64	Soluciones de Windows Server x64
WINDOWS_8	Cliente de Windows 8
WINDOWS_8_X64	Cliente Windows 8 x64
WINDOWS_8_ARM	Cliente Windows 8 RT
WINDOWS_8_SERVER_X64	Windows Server 2012
WINDOWS_v63	Cliente de Windows 8.1
WINDOWS_v63_X64	Cliente Windows 8.1 x64
WINDOWS_v63_ARM	Cliente Windows 8.1 RT
WINDOWS_v63_SERVER_X64	Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL	Cliente Windows 10 versiones 1506 y 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL	Cliente Windows 10 versiones 1506 y 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL	Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL	Cliente Windows 10 versiones 1506 y 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL	Cliente Windows 10 versiones 1506 y 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL	Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL	Cliente Windows 10 versión 1607
WINDOWS_v100_X64_RS1_FULL	Cliente Windows 10 versión 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL	Windows Server 2016 x64 (RS1)
WINDOWS_v100_RS2_FULL	Cliente Windows 10 RS2
WINDOWS_v100_X64_RS2_FULL	Cliente Windows 10 RS2 x64
WINDOWS_v100_RS3_FULL	Cliente Windows 10 RS3
WINDOWS_v100_X64_RS3_FULL	Cliente Windows 10 RS3 x64
WINDOWS_v100_ARM64_RS3_FULL	Cliente Windows 10 RS3 Arm64
WINDOWS_v100_RS4_FULL	Cliente Windows 10 RS4
WINDOWS_v100_X64_RS4_FULL	Cliente Windows 10 RS4 x64
WINDOWS_v100_ARM64_RS4_FULL	Cliente Windows 10 RS4 Arm64
WINDOWS_v100_SERVER_X64_RS5_FULL	Windows Server 2019
WINDOWS_v100_RS5_FULL	Windows 10 RS5 x86
WINDOWS_v100_X64_RS5_FULL	Cliente Windows 10 RS5 x64
WINDOWS_v100_19H1_FULL	Cliente Windows 19H1 x86
WINDOWS_v100_X64_19H1_FULL	Cliente Windows 19H1 x64
WINDOWS_v100_ARM64_19H1_FULL	Cliente Windows 19H1 Arm64
WINDOWS_v100_VB_FULL	Cliente Windows 10, versión 2004 x86
WINDOWS_v100_X64_VB_FULL	Cliente Windows versión 2004 x64
WINDOWS_v100_ARM64_VB_FULL	Cliente Windows versión 2004 Arm64
WINDOWS_v100_SERVER_X64_FE_FULL	Windows - Server, versión 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL	Windows - Server, versión 21H2 Arm64
WINDOWS_v100_X64_CO_FULL	Windows - Cliente, versión 21H2 x64
WINDOWS_v100_ARM64_CO_FULL	Windows - Cliente, versión 21H2 Arm64
WINDOWS_v100_X64_NI_FULL	Cliente Windows 11, versión 22H2 x64
WINDOWS_v100_ARM64_NI_FULL	Cliente Windows 11, versión 22H2 Arm64
WINDOWS_v100_X64_GE_FULL	Cliente Windows 11, versión 24H2 x64
WINDOWS_v100_ARM64_GE_FULL	Cliente Windows 11, versión 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL	Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL	Windows Server 2025 ARM64

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.

Estado HTTP	Descripción
400: Solicitud incorrecta	Solicitud con formato incorrecto (por ejemplo, sintaxis de solicitud con formato incorrecto, trama de mensajes de solicitud no válida o enrutamiento de solicitudes erróneas)
401 - No autorizado	Error de autenticación o no proporcionado
403 - Prohibido	Prohibido acceder a un recurso.
404 – Not Found	No se encuentra la entidad solicitada.
415 - Unsupported Media Type	La carga está en un formato no compatible con este método en el recurso de destino.
422 - Unprocessable Entity	Errores de validación.
429 - Too Many Requests	Se envían demasiadas solicitudes. Las llamadas se limitan y el tiempo de retroceso se proporciona en la respuesta.
500 - Internal Server Error	Error irrecuperable en el servidor de API.

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

Código de error	Mensaje de error	Descripción
InvalidInput		Se devuelve cuando se produce un error en una validación de entrada.
RequestInvalidForCurrentState	Solo se pueden confirmar envíos pendientes	Se devuelve cuando se aplica una confirmación en un envío que no está en estado pendiente.
RequestInvalidForCurrentState	El envío inicial ya existe	Se devuelve cuando se crea un envío inicial para un controlador que ya tiene un envío inicial.
RequestInvalidForCurrentState	No se puede crear el envío derivado porque no se creó ningún envío inicial	Se devuelve cuando se crea un envío derivado para un controlador que no tiene un envío inicial.
UpdateUnauthorized	No autorizado para actualizar el producto	Se devuelve al intentar actualizar un producto compartido (revendido) ya que no se pueden actualizar los productos compartidos.
UpdateUnauthorized	No se puede actualizar el producto sin un envío inicial	Se devuelve al intentar actualizar un producto que no tiene un envío inicial.
UpdateUnauthorized	No se puede actualizar el producto porque se produjo un error en el flujo de trabajo	Se devuelve al intentar actualizar un producto que tiene un flujo de trabajo con errores.
UpdateUnauthorized	La fecha del anuncio no se puede actualizar una vez finalizado el proceso de ingesta	Se devuelve cuando se actualiza la fecha del anuncio una vez completada la ingesta.
UpdateUnauthorized	El nombre del producto no se puede actualizar en este momento. Inténtelo de nuevo.
UpdateUnauthorized	No autorizado para actualizar el envío	Se devuelve al intentar actualizar un envío de un producto compartido (revendido) ya que no se pueden actualizar los productos compartidos.
UpdateUnauthorized	No se puede actualizar el envío porque se produjo un error en los flujos de trabajo	Se devuelve al intentar actualizar un envío que tiene un flujo de trabajo con errores.
EntityNotFound	No se encontró ningún envío	Se devuelve al intentar confirmar un envío que no existe.
EntityNotFound	No se encontró el producto	Se devuelve al intentar crear un envío para el que no existe un producto.
InvalidInput	Los controladores de extensión deben publicarse como una actualización automática. IsAutoInstallDuringOSUpgrade o isAutoInstallOnApplicableSystems debe ser true.	Se devuelve cuando se crea una etiqueta de envío de Windows Update para una extensión INF sin elegir isAutoInstallDuringOSUpgrade o isAutoInstallOnApplicableSystems.
InvalidInput	Los CHID solo se permiten cuando HardwareIds son para sistemas operativos Windows 10 y versiones posteriores.	Se devuelve cuando se crea una etiqueta de envío destinada al sistema operativo inferior a Windows 10 con el destino de CHID. El destino de CHID solo es aplicable a Windows 10 y versiones posteriores.
InvalidInput	No se puede actualizar la etiqueta de envío cuando otro flujo de trabajo está en curso. Inténtelo de nuevo.	Se devuelve cuando se actualiza una etiqueta de envío cuando un flujo de trabajo anterior todavía está en curso.
RequestInvalidForCurrentState	No se puede crear la etiqueta de envío de publicación para la bandeja de entrada o el tipo de sistema. Solo se puede compartir la etiqueta de envío.	Se devuelve cuando se crea la etiqueta de envío de Windows Update en un controlador de bandeja de entrada o en un sistema.
RequestInvalidForCurrentState	El envío aún no está listo para crear la etiqueta de envío. Vuelva a intentarlo más tarde.	Se devuelve cuando se crea una etiqueta de envío sin esperar a que se complete la preparación o el preprocesamiento.

Consulte también

Ejemplos de API del panel de hardware (GitHub)

Compartir a través de

Obtención de datos de producto

Requisitos previos

Recursos de datos

Recurso de producto

Recurso de envío

Objeto de estado de flujo de trabajo

Objeto de descarga

Objeto de vínculo

Objeto de atributo adicional

Objeto StorageController

Objeto RaidController

Objeto SVVP

Lista de tipos de productos

Lista de códigos de familia del sistema operativo

Lista de códigos de sistema operativo

Códigos de error

Consulte también

Comentarios

Recursos adicionales