Obter dados do produto

Artigo
06/27/2024

Use os seguintes métodos nas APIs de Hardware da Microsoft para obter dados de produtos de hardware registrados em sua Conta do Centro de Desenvolvimento. Para obter uma introdução às APIs de hardware da Microsoft, incluindo pré-requisitos para usar a API, consulte Gerenciar envios de hardware usando APIs.

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

Antes de usar esses métodos, o produto já deve existir em sua conta do Centro de Desenvolvimento. Para criar ou gerenciar envios de produtos, consulte os métodos em Gerenciar envios de produtos.

Método	URI	Descrição
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/`	Obtenha dados para todos os seus produtos
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}`	Obter dados para um produto específico
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions`	Obter dados para todos os envios de um produto
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions/{submissionId}`	Obter dados para um envio específico de um produto

Pré-requisitos

Se você ainda não tiver feito isso, conclua todos os pré-requisitos para as APIs de hardware da Microsoft antes de tentar usar qualquer um desses métodos.

Recursos de dados

Os métodos de APIs de hardware da Microsoft para obter dados do produto usam os seguintes recursos de dados JSON

Recurso de produto

Esse recurso representa um produto de hardware (driver) registrado em sua conta.

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

Este recurso tem os seguintes valores

Valor	Type	Descrição
ID	Longo	A ID privada do produto
sharedProductId	Longo	A ID do produto compartilhada do produto
Links	matriz de objetos	Consulte o objeto de link para obter mais detalhes
isCommitted	Booliano	Indica se o produto tem pelo menos um envio confirmado
isExtensionInf	Booliano	(PRETERIDO) Indica se o produto é um driver de extensão. Esse campo foi preterido e não deve mais ser usado. isExtensionInf foi movido para a propriedade de nível de envio.
deviceMetadataIds	matriz de GUIDs	GUIDs que mapeiam envios de metadados de dispositivo para o driver
deviceType	String	Indica o tipo de dispositivo. Os valores possíveis são: "interno" - Um componente interno, dispositivo faz parte de um sistema e se conecta dentro do PC "externo" - Um componente externo, dispositivo é um dispositivo externo (periférico) que se conecta a um PC "internalExternal" - Ambos, dispositivo pode ser conectado internamente (dentro de um PC) e externamente (periférico) "notSet" – sem dados disponíveis
isTestSign	Booliano	Indica se o produto é um driver assinado de teste. Para obter mais informações sobre pacotes de driver de assinatura de teste, consulte Programa de assinatura de teste WHQL
isFlightSign	Booliano	Indica se o produto é um motorista de voo assinado. Os drivers de voo assinados são drivers de teste que podem ser publicados via Windows Update. Eles podem ser publicados/instalados somente em computadores que se inscreveram no Programa Windows Insider. Eles podem ser instalados em máquinas sem desbalancear a inicialização segura. Eles não podem ser instalados em computadores de varejo que não fazem parte do Programa Windows Insider.
marketingNomes	matriz de cadeias de caracteres	Nomes de marketing ou aliases do produto
productName	String	O nome do driver conforme especificado durante a criação
selectedProductTypes	dicionário	Par de valores de chave onde ambos são cadeias de caracteres. Key representa o código da família do sistema operacional. Para obter uma lista de códigos da família do sistema operacional, consulte a lista de códigos da família do sistema operacional. O valor representa o tipo do produto. Para obter uma lista de tipos de produtos, consulte Tipos de produtos.
requestedSignatures	matriz de cadeias de caracteres	Lista de assinaturas do sistema operacional para o qual o produto é certificado. Para obter uma lista de todos os sistemas operacionais, consulte lista de códigos do sistema operacional
adicionalAtributos	Objeto	Consulte o objeto de atributos adicionais para obter mais detalhes.
testHarness	string	O tipo de pacote que foi enviado. Os valores possíveis são HLK HCK attestation Notset
AnúncioData	datetime	A data em que o produto será incluído no Catálogo do Windows Server

Recurso de envio

Esse recurso representa um envio de um produto.

{
  "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 possui os seguintes valores:

Valor	Type	Descrição
ID	longo	O ID do envio
Productid	long	A ID do produto privado à qual este envio está associado
status do fluxo de trabalho	objeto	Isso está disponível apenas ao recuperar detalhes de um envio específico. Este objeto descreve o status do fluxo de trabalho para esse envio. Consulte o objeto de status do fluxo de trabalho para obter mais detalhes
Links	matriz de objetos	Consulte o objeto de link para obter mais detalhes
commitStatus	Consulte Gerenciar envios de produtos para obter mais detalhes.
isExtensionInf	Booliano	Indica se o envio é um driver de extensão
éUniversal	Booliano	Indica se o envio passa no teste da API Universal. Um driver é compatível com DCHU se for Decalarative e Universal
isDeclarativeInf	Booliano	Indica se o envio passa no teste INVerif Declarativo. Um driver é compatível com DCHU se for Decalarative e Universal
Nome	string	O nome da submissão
Type	string	Indica se o envio é inicial ou derivado. Os valores possíveis são inicial Derivada
downloads	objeto	Isso está disponível apenas ao recuperar detalhes de um envio específico. Este objeto descreve os downloads disponíveis para o envio. Consulte o objeto de download para obter mais detalhes.

Objeto Status do fluxo de trabalho

Esse objeto representa o status do fluxo de trabalho para uma determinada entidade

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

Este objeto possui os seguintes valores

Valor	Type	Descrição
currentStep	string	O nome da etapa atual no fluxo de trabalho geral dessa entidade. Para ingestão/envio de pacotes os valores possíveis são (descrição entre parênteses): packageInfoValidation (Validando metadados e conteúdo do pacote) preparação (Preparando a embalagem para processamento) varredura (Verificando o conteúdo do pacote em busca de malware) validação (Validação dos resultados dos ensaios) catalogCreation (Criando um catálogo de segurança para pacote) manualReview (Em revisão manual) assinatura (Assinando os binários) finalizeIngestion (Completando a ingestão e preparando os arquivos assinados para download ou publicação)
Estado	string	O estado da etapa atual. Os valores possíveis são: notStarted iniciado falhou concluído
Mensagens	matriz	Uma matriz de cadeias de caracteres para fornecer mensagens sobre a etapa atual (especialmente em caso de falha)

Objeto de download

Esse objeto representa os downloads de um determinado envio.

{
  "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 possui os seguintes valores

Valor	Type	Descrição
Itens	matriz	Uma matriz de tipos de download e a URL de cada um. Por favor, consulte abaixo para obter detalhes
Type	string	O tipo de pacote disponível para download. Os valores possíveis são: "initialPackage" – pacote carregado pelo usuário (em caso de novo envio, ele aponta para o URI SAS para carregar o pacote) "derivedPackage" – shell para envios derivados "signedPackage" – pacote assinado pela Microsoft "certificationReport" – relatório de certificação do produto assinado driverMetadata - link aponta para um arquivo que permite o download de metadados do driver. Para obter mais detalhes, consulte os metadados do pacote de driver. Notas Externas Desconhecido
Mensagens	matriz	Uma matriz de cadeias de caracteres para fornecer mensagens sobre os arquivos para download

Objeto de link

Este objeto representa uma lista de links úteis para a entidade que contém

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

Este objeto possui os seguintes valores

Valor	Type	Descrição
Href	String	A URL para acessar o recurso via API
Rel	String	Tipo do recurso. Os valores possíveis são: self – Link aponta para si mesmo next_link – Vincular pontos para o próximo recurso normalmente usado para paginação get_submissions – pontos de link para todos os envios de um produto commit_submission – pontos de link para confirmação de uma submissão update_submission – pontos de link para atualização da submissão update_shippinglabel – pontos de link para atualização da etiqueta de remessa
Método	String	Tipo do método http a ser usado ao invocar a URL. Os valores possíveis são: GET POSTAR PATCH

Objeto de atributo adicional

Este objeto fornece atributos adicionais sobre o produto se ele for do tipo controlador RAID, controlador de armazenamento ou programa de validação de virtualização de servidor (SVVP). Ele pode conter um dos três tipos de objetos – StorageController, RaidController ou SVVP.

Objeto StorageController

Valor	Type	Descrição
biosVersão	string	Versão da ROM Bios
firmwareVersion	string	Versão do Firmware
driverVersion	string	Versão do driver
driverName	string	Nome do driver
deviceVersion	string	Versão do Dispositivo
chipsetNome	string	Nome do chipset
usadoProprietário	boolean	Multi-pathing suportado através de driver proprietário. Se verdadeiro, então proprietaryName e proprietaryVersion são madatory
proprietárioNome	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão do software multi-path
usadosMicrosoft	boolean	Microsoft MPIO suportado através de módulo específico do dispositivo. Se verdadeiro, então microsoftName e microsoftVersion são madatory
MicrosoftName	string	Nome do software de vários caminhos
MicrosoftVersion	string	Versão do software multi-path
usedBootSupport	boolean	Suporte de inicialização
usadoBetterBoot	boolean	Suporte a inicialização >de 2,2 TB. Se for verdade, a versão UEFI suportada e a versão ACPI suportada são obrigatórias
uefiVersion	string	Versão UEFI suportada
acpiVersion	string	Versão ACPI suportada
suportaSector4K512E	boolean	Tamanho do setor de suporte de 4K/512e
suportaSector4K4K	boolean	Tamanho do setor de suporte de 4K/4K
suportesDiferencial	boolean	Diferencial (diferencial de alta tensão)

Objeto RaidController

Valor	Type	Descrição
firmwareVersion	string	Versão do Firmware
filterVersion	string	Versão do driver
driverVersion	string	Versão do filtro
usadoProprietário	boolean	Multi-pathing suportado através de driver proprietário. Se verdadeiro, então proprietaryName e proprietaryVersion são obrigatórios
proprietárioNome	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão do software multi-path
usadosMicrosoft	boolean	Microsoft MPIO suportado através de módulo específico do dispositivo. Se true, então microsoftName e microsoftVersion são obrigatórios
MicrosoftName	string	Nome do software de vários caminhos
MicrosoftVersion	string	Versão do software multi-path
isThirdPartyNeeded	boolean	Driver de terceiros que não sejam da Microsoft necessário para conectividade
isSES	boolean	SES (Serviços de Gabinete SCSI). Indica se um SES está incluído. SCSI é o termo padrão para um barramento de serviço que conecta dispositivos em um sistema, originalmente Small Computer System Interface. SES é a abreviação de SCSI Enclosure Services.
isSAFTE	boolean	SAF-TE (Especificação ANBll). Indica se um SAF-TE está incluído. ANBll uma especificação da indústria. SAF-TE é a abreviação de SCSI Accessed Fault Tolerant Enclosures. SCSI é o termo padrão para um barramento de serviço que conecta dispositivos em um sistema, originalmente Small Computer System Interface.
additionalInfo	string	Informações adicionais

Objeto SVVP

Valor	Type	Descrição
productVersion	string	Versão do Produto
supportLink	string	URL do suporte
guestOs	string	SO convidado. Os valores possíveis são: Windows Server 2008 Windows Server 2008 Versão 2 Windows Server 2012 Windows Server 2012 R2
processorArchitecture	string	Arquitetura do processador de hardware. Os valores possíveis são: Xeon Opteron Itanium 2
maxProcessadores	Número inteiro	Processadores máximos na VM
maxMemória	Número inteiro	Memória máxima na VM (em GB)

Lista de Tipos de Produtos

Um produto pode ser dos seguintes tipos. Essas informações são usadas junto com o sistema operacional para identificar a aplicabilidade.

Impressora 3D
Sensor do acelerômetro
Tudo em um
Tudo em um com toque
Dispositivo de áudio
Objetos de processamento de áudio
Controlador Bluetooth
Controlador Bluetooth não USB
Câmera
Sensor da câmera
Cluster
Acelerador de computação MCDM 2.7
Acelerador de Computação MCDM 3.1
Acelerador de computação MCDM 3.2
Tablet conversível
Área de trabalho
Renderizador de mídia digital
Servidor de Mídia Digital
Câmeras fotográficas digitais
Câmeras de Vídeo Digital
Dispositivos habilitados para gerenciamento de varredura de distribuição
Impressora multifuncional WSD corporativa
Leitor de impressão digital
Controlador de jogo
Controlador genérico
Dispositivo portátil genérico
Adaptador gráfico MCDM2.7
Adaptador gráfico MCDM2.8
Adaptador gráfico MCDM2.9
Adaptador gráfico MCDM3.0
Adaptador gráfico WDDM1.0
Adaptador gráfico WDDM1.1
Adaptador gráfico WDDM1.2
Adaptador gráfico WDDM1.2 DisplayOnly
Adaptador gráfico WDDM1.2 RenderOnly
Adaptador gráfico WDDM1.3
Adaptador gráfico WDDM1.3 DisplayOnly
Adaptador gráfico WDDM1.3 RenderOnly
Adaptador gráfico WDDM2.0
Adaptador gráfico WDDM2.0 somente exibição
Somente renderização do adaptador gráfico WDDM2.0
Adaptador gráfico WDDM2.1
Adaptador gráfico WDDM2.1 somente exibição
Somente renderização do adaptador gráfico WDDM2.1
Adaptador gráfico WDDM2.2
Adaptador gráfico WDDM2.2 somente exibição
Somente renderização do adaptador gráfico WDDM2.2
Adaptador gráfico WDDM2.3
Adaptador gráfico WDDM2.3 somente exibição
Somente renderização do adaptador gráfico WDDM2.3
Adaptador gráfico WDDM2.4
Adaptador gráfico WDDM2.4 somente exibição
Somente renderização do adaptador gráfico WDDM2.4
Adaptador gráfico WDDM2.4 VM
Adaptador gráfico WDDM2.5
Adaptador gráfico WDDM2.5 somente exibição
Somente renderização do adaptador gráfico WDDM2.5
Adaptador gráfico WDDM2.5 VM
Adaptador gráfico WDDM2.6
Adaptador gráfico WDDM2.6 somente exibição
Adaptador gráfico WDDM2.6 renderizar somente
Adaptador gráfico WDDM2.6 VM
Adaptador gráfico WDDM2.7
Adaptador gráfico WDDM2.7 somente exibição
Somente renderização do adaptador gráfico WDDM2.7
Adaptador gráfico WDDM2.7 VM
Adaptador gráfico WDDM2.8
Adaptador gráfico WDDM2.8 somente vídeo
Somente renderização do adaptador gráfico WDDM2.8
Adaptador gráfico WDDM2.8 VM
Adaptador gráfico WDDM2.9
Adaptador gráfico WDDM2.9 somente exibição
Adaptador gráfico WDDM2.9 renderizar somente
Adaptador gráfico WDDM2.9 VM
Adaptador gráfico WDDM3.0
Adaptador gráfico WDDM3.0 somente exibição
Somente renderização do adaptador gráfico WDDM3.0
Adaptador gráfico WDDM3.0 VM
Adaptador gráfico WDDM3.1
Adaptador gráfico WDDM3.1 somente exibição
Somente renderização do adaptador gráfico WDDM3.1
Adaptador gráfico WDDM3.1 VM
Adaptador gráfico WDDM3.2
Adaptador gráfico WDDM3.2 somente exibição
Somente renderização do adaptador gráfico WDDM3.2
VM do adaptador gráfico WDDM3.2
Tablet gráfico
Sensor de giroscópio
Disco Rígido
Transformações multifuncionais de hardware
Teclado
Teclado Video Mouse Switch
LAN
LAN (Servidor)
LAN CS
Máquina Virtual LAN (Servidor)
Laptop
Laptop com Touch
LCD
Sensor de Luz
Sensor de Localização
Player de Mídia
CDMA de banda larga móvel
Banda Larga Móvel GSM
Celular
Monitor
Placa-mãe
Fusão de Sensores de Movimento
Impressora Multifuncional
Proximidade de Campo próximo
Dispositivo de mídia de rede
NFC
Leitor de cartão inteligente NFC
Unidade óptica
Digitalizador de caneta
Apontando Desenho
Touchpadde precisão
Sensor de Presença
Impressora
Projector
Armazenamento removível
Roteador
Scanner
Controlador SDIO
Servidor
Programa de validação de virtualização de servidor
Tablet de assinatura
Cartões Inteligentes
Leitor de cartão inteligente
Matriz de Armazenamento
Controlador de armazenamento
Adaptador de espaços de armazenamento
Unidade de espaços de armazenamento
Tablet
Tocar
Monitor de toque
TPM20
PC Ultra-Móvel
PC Ultra-Mobile com Touch
Controlador USB
Hub USB
Webcam
WLAN
WLAN CSB
Impressora multifuncional WSD
Impressora WSD
WSD Scanner

Lista de códigos da família de sistemas operacionais

A tabela a seguir lista os Códigos de Família do Sistema Operacional e suas descrições.

Código da família OS	Descrição
WindowsMe	Windows Me
Windows2000	Windows 2000
Janelas 98	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
Janelas 7	Windows 7
Windows2008ServerR2	Windows Server 2008 Versão 2
WindowsServerSoluções	Soluções do Windows Server
Janelas 8	Windows 8
Windows8Server	Windows Server 2012
Janelas 81	Windows 8.1
Windows81Server	Windows Server 2012 R2
Windows_v100	Limite do Windows 10
Windows_v100Server	Windows Server Threshold
Windows_v100_RS1	Atualização de Aniversário do Windows 10
Windows_v100Server_RS1	Windows Server 2016
Windows_v100_RS2	Atualização do Windows 10 RS2
Windows_v100Server_RS2	Windows Server RS2
Windows_v100_RS3	Atualização do Windows 10 RS3
Windows_v100Server_RS3	Windows Server RS3
Windows_v100_RS4	Atualização do Windows 10 RS4
Windows_v100Server_RS5	Windows Server 2019
Windows_v100_RS5	Janelas 10 RS5 x86
Windows_v100_RS5	Janelas 10 RS5 x64
Windows_v100_19H1	Atualização do Windows 10 19H1
Windows_v100_VB	Windows 10 versão 2004
Windows_v100Server_FE	Windows - Server, versão 21H2
Windows_v100_CO	Windows - Cliente, versão 21H2
Windows_v100_NI	Windows 11 Client, versão 22H2
Windows_v100_GE	Windows 11 Client, versão 24H2
Windows_v100Server_GE	Windows Server 2025

Lista de códigos do sistema operacional

A tabela a seguir lista os códigos do sistema operacional e suas descrições.

Código do SO	Descrição
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	Centro de mídia do Windows XP
WINDOWS_2003	Windows Server 2003
WINDOWS_2003_IA64	Windows Server 2003 IA64
WINDOWS_2003_X64	Windows Server 2003 X64
WINDOWS_VISTA	Cliente do Windows Vista
WINDOWS_VISTA_X64	Cliente do 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 do Windows 7
WINDOWS_7_X64	Cliente do Windows 7 x64
WINDOWS_2008_SERVER_R2_IA64	Windows Server 2008 Versão 2 IA64
WINDOWS_2008_SERVER_R2_X64	Windows Server 2008 Versão 2 x64
WINDOWS_SERVER_SOLUTIONS_X64	Soluções do Windows Server x64
WINDOWS_8	Cliente do Windows 8
WINDOWS_8_X64	Cliente do Windows 8 x64
WINDOWS_8_ARM	Cliente RT do Windows 8
WINDOWS_8_SERVER_X64	Windows Server 2012
WINDOWS_v63	Cliente do Windows 8.1
WINDOWS_v63_X64	Cliente do Windows 8.1 x64
WINDOWS_v63_ARM	Windows 8.1 RT Cliente
WINDOWS_v63_SERVER_X64	Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL	Windows 10 Client versões 1506 e 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL	Windows 10 Client versões 1506 e 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL	Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL	Windows 10 Client versões 1506 e 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL	Windows 10 Client versões 1506 e 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL	Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL	Windows 10 Client versão 1607
WINDOWS_v100_X64_RS1_FULL	Windows 10 Client versão 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL	Windows Server 2016 x64 (RS1)
WINDOWS_v100_RS2_FULL	Cliente RS2 do Windows 10
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 Cliente x64
WINDOWS_v100_RS3_FULL	Cliente RS3 do Windows 10
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 Cliente x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 Cliente Arm64
WINDOWS_v100_RS4_FULL	Cliente RS4 do Windows 10
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 Cliente x64
WINDOWS_v100_ARM64_RS4_FULL	Windows 10 RS4 Cliente Arm64
WINDOWS_v100_SERVER_X64_RS5_FULL	Windows Server 2019
WINDOWS_v100_RS5_FULL	Janelas 10 RS5 x86
WINDOWS_v100_X64_RS5_FULL	Windows 10 RS5 Cliente x64
WINDOWS_v100_19H1_FULL	Cliente do Windows 19H1 x86
WINDOWS_v100_X64_19H1_FULL	Cliente do Windows 19H1 x64
WINDOWS_v100_ARM64_19H1_FULL	Windows 19H1 Cliente Arm64
WINDOWS_v100_VB_FULL	Windows 10 versão 2004 Client x86
WINDOWS_v100_X64_VB_FULL	Windows versão 2004 Client x64
WINDOWS_v100_ARM64_VB_FULL	Windows versão 2004 Client Arm64
WINDOWS_v100_SERVER_X64_FE_FULL	Windows - Server, versão 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL	Windows - Server, versão 21H2 Arm64
WINDOWS_v100_X64_CO_FULL	Windows - Cliente, versão 21H2 x64
WINDOWS_v100_ARM64_CO_FULL	Windows - Cliente, versão 21H2 Arm64
WINDOWS_v100_X64_NI_FULL	Windows 11 Client, versão 22H2 x64
WINDOWS_v100_ARM64_NI_FULL	Windows 11 Client, versão 22H2 Arm64
WINDOWS_v100_X64_GE_FULL	Windows 11 Client, versão 24H2 x64
WINDOWS_v100_ARM64_GE_FULL	Windows 11 Client, versão 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL	Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL	Windows Server 2025 ARM64

Códigos do Erro

Os códigos de erro são aplicáveis a todos os métodos da Web da API. Se a solicitação não puder ser concluída com êxito, a resposta conterá um dos seguintes códigos de erro HTTP.

Status HTTP	Descrição
400 – Solicitação incorreta	Solicitação não bem formada (por exemplo, sintaxe de solicitação malformada, enquadramento de mensagem de solicitação inválido ou roteamento de solicitação enganoso)
401 - Não autorizado	Falha na autenticação ou não fornecida
403 - Proibido	Proibido acessar um recurso
404 – Não encontrado	A entidade solicitada para não foi encontrada.
415 - Tipo de mídia não suportado	A carga útil está em um formato não suportado por esse método no recurso de destino.
422 - Entidade não processável	Falhas de validação.
429 - Demasiados pedidos	Estão a ser enviados demasiados pedidos. As chamadas são limitadas e o tempo de recuo é fornecido na resposta.
500 - Erro interno do servidor	Ocorreu um erro irrecuperável no servidor de API.

Se houver falhas de validação funcional, o corpo da resposta conterá um dos seguintes códigos de erro funcionais.

Código de erro	Mensagem de erro	Descrição
InvalidInput		Retornado quando uma validação de entrada falha
RequestInvalidForCurrentState	Somente envios pendentes podem ser confirmados	Retornado quando uma confirmação é aplicada em um envio que não está no estado pendente
RequestInvalidForCurrentState	A submissão inicial já existe	Retornado quando um envio inicial é criado para um driver que já tem um envio inicial
RequestInvalidForCurrentState	Não é possível criar envio derivado, pois nenhum envio inicial foi criado	Retornado quando um envio derivado é criado para um driver que não tem um envio inicial
UpdateUnauthorized	Não autorizado a atualizar o produto	Retornado ao tentar atualizar um produto que foi compartilhado (revendido), já que os produtos compartilhados não podem ser atualizados
UpdateUnauthorized	Não é possível atualizar o produto sem um envio inicial	Retornado ao tentar atualizar um produto que não tem um envio inicial
UpdateUnauthorized	Não é possível atualizar o produto porque o fluxo de trabalho falhou	Retornado ao tentar atualizar um produto que tem um fluxo de trabalho com falha
UpdateUnauthorized	A Data do Anúncio não pode ser atualizada após a conclusão do processo de ingestão	Retornado quando a data de anúncio é atualizada após a conclusão da ingestão
UpdateUnauthorized	O nome do produto não pode ser atualizado no momento. Tente novamente
UpdateUnauthorized	Não autorizado a atualizar o envio	Retornado ao tentar atualizar um envio de um produto que foi compartilhado (revendido), já que os produtos compartilhados não podem ser atualizados
UpdateUnauthorized	Não é possível atualizar o envio, pois os fluxos de trabalho falharam	Retornado ao tentar atualizar um envio que tem um fluxo de trabalho com falha
EntityNotFound	Nenhuma submissão encontrada	Retornado ao tentar confirmar um envio que não existe
EntityNotFound	Produto não encontrado	Retornado ao tentar criar um envio para o qual um produto não existe
InvalidInput	Os drivers de extensão devem ser publicados como uma atualização automática. Qualquer um dos isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems deve ser true.	Retornado quando uma etiqueta de remessa do Windows Update para uma extensão INF é criada sem escolher isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems
InvalidInput	Chids são permitidos somente quando HardwareIds são para sistemas operacionais Windows10 & Acima.	Retornado quando uma etiqueta de remessa direcionada ao sistema operacional inferior ao Windows 10 é criada com a segmentação CHID. A segmentação CHID é aplicável apenas para o Windows 10 e superior.
InvalidInput	Não é possível atualizar a etiqueta de remessa quando outro fluxo de trabalho está em andamento. Tente novamente.	Retornado quando uma etiqueta de remessa é atualizada quando um fluxo de trabalho anterior ainda está em andamento.
RequestInvalidForCurrentState	Não é possível criar etiqueta de remessa de publicação para caixa de entrada ou tipo de sistema. Só se pode compartilhar a etiqueta de envio.	Retornado quando a etiqueta de remessa do Windows Update é criada em um driver de caixa de entrada ou em um sistema.
RequestInvalidForCurrentState	O envio ainda não está pronto para criar a etiqueta de envio. Tente novamente mais tarde.	Retornado quando uma etiqueta de remessa é criada sem esperar a preparação ou o pré-processamento para concluir.

Confira também

exemplos de API de painel de hardware (GitHub)

Compartilhar via

Obter dados do produto

Pré-requisitos

Recursos de dados

Recurso de produto

Recurso de envio

Objeto Status do fluxo de trabalho

Objeto de download

Objeto de link

Objeto de atributo adicional

Objeto StorageController

Objeto RaidController

Objeto SVVP

Lista de Tipos de Produtos

Lista de códigos da família de sistemas operacionais

Lista de códigos do sistema operacional

Códigos do Erro

Confira também

Comentários

Comentários

Recursos adicionais