Obter dados do produto

Artigo
10/01/2024

Use os seguintes métodos na APIs de hardware da Microsoft para recuperar dados para etiquetas de remessa 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 e o envio já deve estar 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/my/hardware/products/`	Obter dados para todos os seus produtos
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}`	Obter dados de um produto específico
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions`	Obter dados para todos os envios de um produto
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}`	Obter dados de um envio específico de um produto

Pré-requisitos

Preencha 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 de produtos usam os seguintes recursos de dados JSON

Recurso de produto

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

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

Valor	Type	Descrição
ID	Longo	A ID do produto privado
sharedProductId	Longo	A ID de produto compartilhada
Links	matriz de objetos	Consulte o objeto do link para obter mais detalhes
isCommitted	Booliano	Mostra se o produto tem pelo menos um envio confirmado
isExtensionInf	Booliano	(OBSOLETO) Indica se o produto é um driver de extensão. Este campo é obsoleto e não deve ser mais usado. isExtensionInf foi movido para uma propriedade de nível de envio.
deviceMetadataIds	matriz de GUIDs	GUIDs que mapeiam envios de metadados do dispositivo para o driver
deviceType	String	Indica o tipo de dispositivo. Os valores possíveis são: "interno" - Um componente interno, o dispositivo é 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, o 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 driver assinado da versão de pré-lançamento. Os drivers assinados por versão de pré-lançamento são drivers de teste que podem ser publicados por meio do Windows Update. Eles podem ser publicados/instalados apenas em computadores inscritos no Programa Windows Insider. Eles podem ser instalados em computadores sem desabilitar a inicialização segura. Eles não podem ser instalados em computadores de varejo que não fazem parte do Programa Windows Insider.
marketingNames	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-chave em que ambos são strings. Chave representa o código da família do sistema operacional. Para obter uma lista de códigos de família de sistemas operacionais, consulte Lista de códigos de família de sistemas operacionais. 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 as quais o produto é certificado. Para obter uma lista de todos os sistemas operacionais, consulte lista de códigos do sistema operacional.
additionalAttributes	Objeto	Para obter mais informações, consulte objeto de atributos adicionais.
testHarness	string	O tipo de pacote enviado. Os valores possíveis são os seguintes: hlk hck attestation notset
announcementDate	datetime	A data na qual o produto foi incluído no Catálogo do Windows Server.

Recurso de envio

Esse recurso representa o 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 tem os seguintes valores:

Valor	Type	Descrição
ID	longo	A ID do envio
Productid	long	A ID de produto privada para a qual este envio está associado
workflowstatus	objeto	Está disponível apenas ao recuperar detalhes de um envio específico. Este objeto descreve o status do fluxo de trabalho para esse envio. Para obter mais informações, consulte objeto de status do fluxo de trabalho.
Links	matriz de objetos	Consulte o objeto do 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
isUniversal	Booliano	Indica se o envio passa no teste da API Universal. Um driver é compatível com DCHU se for declarativo e universal
isDeclarativeInf	Booliano	Indica se o envio passa no teste INVerif declarativo. Um driver é compatível com DCHU se for declarativo e universal.
Nome	string	O nome do envio.
Type	string	Indica se o envio é um envio inicial ou derivado. Os valores possíveis são os seguintes: inicial derivado
downloads	objeto	Está disponível apenas ao recuperar detalhes de somente um envio específico. Esse objeto descreve os downloads disponíveis para o envio. Para saber mais, consulte objeto de download.

Objeto de Status do Fluxo de Trabalho

Esse objeto representa o status do fluxo de trabalho de 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 pacote, os valores possíveis são (descrição entre parênteses): packageInfoValidation (Validando metadados e conteúdo do pacote) preparation (Preparando o pacote para processamento) scanning (Verificando o conteúdo do pacote em busca de malware) validation (Validação dos resultados dos testes) catalogCreation (Criando um catálogo de segurança para o pacote) manualReview (Em revisão manual) signing (Assinando os binários) finalizeIngestion (Concluindo 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 (principalmente, se houver falha)

Baixar objeto

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.
Type	string	O tipo de pacote disponível para download. Os valores possíveis são: "initialPackage" – pacote carregado pelo usuário (para um 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 - o link aponta para um arquivo que permite o download de metadados do driver. Para obter mais informações, consulte metadados do pacote de driver. ExternalNotes Desconhecido
Mensagens	matriz	Uma matriz de cadeias de caracteres para fornecer mensagens sobre os arquivos para download

Objeto de link

Esse objeto representa uma lista de links úteis para a entidade que o 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 – O link aponta para si mesmo next_link – os pontos de link para o próximo recurso, geralmente usado para paginação get_submissions – os pontos de link para todos os envios de um produto commit_submission – os pontos de link para confirmação de um envio update_submission – os pontos de link para atualização do envio update_shippinglabel – vincular pontos 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 os seguintes: GET POSTAR PATCH

Objeto de atributo adicional

Esse objeto fornece mais atributos 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
biosVersion	string	Versão da BIOS da ROM
firmwareVersion	string	Versão do Firmware
driverVersion	string	Versão do driver
driverName	string	Nome do driver
deviceVersion	string	Versão do Dispositivo
chipsetName	string	Nome do chipset
usedProprietary	boolean	Multi-pathing suportado por meio de driver proprietário. Se for verdadeiro, proprietaryName e proprietaryVersion são obrigatórios.
proprietaryName	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão do software de vários caminhos
usedMicrosoft	boolean	Microsoft MPIO com suporte por meio do módulo específico do dispositivo. Se for verdadeiro, microsoftName e microsoftVersion são obrigatórios.
microsoftName	string	Nome do software de vários caminhos
microsoftVersion	string	Versão do software de vários caminhos
usedBootSupport	boolean	Suporte de inicialização
usedBetterBoot	boolean	Suporte de inicialização > de 2,2 TB. Se for verdadeiro, a versão UEFI com suporte e a versão ACPI com suporte serão obrigatórias
uefiVersion	string	Versão da UEFI compatível
acpiVersion	string	Versão da ACPI compatível
supportsSector4K512E	boolean	Tamanho do setor de suporte de 4K/512e
supportsSector4K4K	boolean	Tamanho do setor de suporte de 4K/4K
supportsDifferential	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	Filtro da versão
usedProprietary	boolean	Multi-pathing suportado por meio de driver proprietário. Se for verdadeiro, proprietaryName e proprietaryVersion são obrigatórios
proprietaryName	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão do software de vários caminhos
usedMicrosoft	boolean	Microsoft MPIO com suporte por meio do módulo específico do dispositivo. Se for verdadeiro, microsoftName e microsoftVersion são obrigatórios
microsoftName	string	Nome do software de vários caminhos
microsoftVersion	string	Versão do software de vários caminhos
isThirdPartyNeeded	boolean	Driver que não seja da Microsoft necessário para conectividade
isSES	boolean	SES (Serviços de Compartimento 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
maxProcessors	Número inteiro	Máximo de processadores na VM
maxMemory	Número inteiro	Memória máxima na VM (em GB)

Lista de tipos de produtos

Um produto pode ser dos tipos a seguir. Juntamente com o sistema operacional, essas informações são usadas para identificar a aplicabilidade.

Impressora 3D
Sensor de acelerômetro
Integrado
Integrado com toque
Dispositivo de áudio
Objetos de processamento de áudio
Controlador Bluetooth
Controlador Bluetooth não USB
Câmera
Sensor de 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 digitais
Dispositivos habilitados para gerenciamento de verificação de distribuição
Impressora multifuncional WSD corporativa
Leitor de impressão digital
Controlador de jogos
Controlador genérico
Dispositivo portátil genérico
Adaptadores gráficos MCDM2.7
Adaptadores gráficos MCDM2.8
Adaptadores gráficos MCDM2.9
Adaptadores gráficos MCDM3.0
Adaptadores gráficos WDDM1.0
Adaptadores gráficos WDDM1.1
Adaptadores gráficos WDDM1.2
Adaptador gráfico WDDM1.2 DisplayOnly
Adaptador gráfico WDDM1.2 RenderOnly
Adaptadores gráficos WDDM1.3
Adaptador gráfico WDDM1.3 DisplayOnly
Adaptador gráfico WDDM1.3 RenderOnly
Adaptadores gráficos WDDM2.0
Adaptador gráfico WDDM2.0 DisplayOnly
Adaptador gráfico WDDM2.0 RenderOnly
Adaptadores gráficos WDDM2.1
Adaptador gráfico WDDM2.1 DisplayOnly
Adaptador gráfico WDDM2.1 RenderOnly
Adaptadores gráficos WDDM2.2
Adaptador gráfico WDDM2.2 DisplayOnly
Adaptador gráfico WDDM2.2 RenderOnly
Adaptadores gráficos WDDM2.3
Adaptador gráfico WDDM2.3 DisplayOnly
Adaptador gráfico WDDM2.3 RenderOnly
Adaptadores gráficos WDDM2.4
Adaptador gráfico WDDM2.4 DisplayOnly
Adaptador gráfico WDDM2.4 RenderOnly
Adaptadores gráficos WDDM2.4 VM
Adaptadores gráficos WDDM2.5
Adaptador gráfico WDDM2.5 DisplayOnly
Adaptador gráfico WDDM2.5 RenderOnly
Adaptadores gráficos WDDM2.5 VM
Adaptadores gráficos WDDM2.6
Adaptador gráfico WDDM2.6 DisplayOnly
Adaptador gráfico WDDM2.6 RenderOnly
Adaptadores gráficos WDDM2.6 VM
Adaptadores gráficos WDDM2.7
Adaptador gráfico WDDM2.7 DisplayOnly
Adaptador gráfico WDDM2.7 RenderOnly
Adaptadores gráficos WDDM2.7 VM
Adaptadores gráficos WDDM2.8
Adaptador gráfico WDDM2.8 DisplayOnly
Adaptador gráfico WDDM2.8 RenderOnly
Adaptadores gráficos WDDM2.8 VM
Adaptadores gráficos WDDM2.9
Adaptador gráfico WDDM2.9 DisplayOnly
Adaptador gráfico WDDM2.9 RenderOnly
Adaptadores gráficos WDDM2.9 VM
Adaptadores gráficos WDDM3.0
Adaptador gráfico WDDM3.0 DisplayOnly
Adaptador gráfico WDDM3.0 RenderOnly
Adaptadores gráficos WDDM3.0 VM
Adaptadores gráficos WDDM3.1
Adaptador gráfico WDDM3.1 DisplayOnly
Adaptador gráfico WDDM3.1 RenderOnly
Adaptadores gráficos WDDM3.1 VM
Adaptadores gráficos WDDM3.2
Adaptador gráfico WDDM3.2 DisplayOnly
Adaptador gráfico WDDM3.2 RenderOnly
Adaptadores gráficos WDDM3.2 VM
Tablet gráfico
Sensor de giroscópio
Disco Rígido
Transformações multifuncionais de hardware
Teclado
Comutador KVM (Keyboard Video Mouse)
LAN
LAN (Servidor)
LAN CS
Máquina virtual LAN (Servidor)
Laptop
Laptop com toque
LCD
Sensor de luz
Sensor de localização
Player de Mídia
Banda larga móvel CDMA
Banda larga móvel GSM
Celular
Monitor
Placa-mãe
Fusão de sensores de movimento
Impressora multifuncional
Proximidade a curta distância
Dispositivo de mídia de rede
NFC
Leitora de cartão inteligente NFC
Unidade óptica
Digitalizador de caneta
Pointing drawing
Touchpadde precisão
Sensor de presença
Impressora
Projector
Armazenamento removível
Roteador
Scanner
SDIO Controller
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
Ultra-Mobile PC
Ultra-Mobile PC com Toque
Controlador USB
Hub USB
Webcam
WLAN
WLAN CSB
Impressora multifuncional WSD
Impressora WSD
Scanner WSD

Lista de códigos de 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 de família do sistema operacional	Descrição
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 Versão 2
WindowsServerSolutions	Windows Server Solutions
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	Atualização de Aniversário do 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	O Windows 10, versão 2004
Windows_v100Server_FE	Windows - Server, versão 21H2
Windows_v100_CO	Windows - Client, 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 sistema operacional	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	Windows XP Media Center
WINDOWS_2003	Windows Server 2003
WINDOWS_2003_IA64	IA64 do Windows Server 2003
WINDOWS_2003_X64	X64 do Windows Server 2003
WINDOWS_VISTA	Windows Vista Client
WINDOWS_VISTA_X64	Windows Vista Client X64
WINDOWS_2008_SERVER	Windows Server 2008
WINDOWS_2008_SERVER_IA64	IA64 do Windows Server 2008
WINDOWS_2008_SERVER_X64	X64 do Windows Server 2008
WINDOWS_HOME_SERVER	Windows Home Server
WINDOWS_7	Cliente do Windows 7
WINDOWS_7_X64	Windows 7 Client 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	Windows Server Solutions x64
WINDOWS_8	Cliente do Windows 8
WINDOWS_8_X64	Windows 8 Client x64
WINDOWS_8_ARM	Windows 8 Client RT
WINDOWS_8_SERVER_X64	Windows Server 2012
WINDOWS_v63	Cliente do Windows 8.1
WINDOWS_v63_X64	Windows 8.1 Client x64
WINDOWS_v63_ARM	Windows 8.1 Client RT
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	Windows 10 RS2 Client
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 Client x64
WINDOWS_v100_RS3_FULL	Windows 10 RS3 Client
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 Client x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 Client Arm64
WINDOWS_v100_RS4_FULL	Windows 10 RS4 Client
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 Client x64
WINDOWS_v100_ARM64_RS4_FULL	Windows 10 RS4 Client Arm64
WINDOWS_v100_SERVER_X64_RS5_FULL	Windows Server 2019
WINDOWS_v100_RS5_FULL	Windows 10 RS5 x86
WINDOWS_v100_X64_RS5_FULL	Windows 10 RS5 Client x64
WINDOWS_v100_19H1_FULL	Windows 19H1 Client x86
WINDOWS_v100_X64_19H1_FULL	Windows 19H1 Client x64
WINDOWS_v100_ARM64_19H1_FULL	Windows 19H1 Client 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 - Client, versão 21H2 x64
WINDOWS_v100_ARM64_CO_FULL	Windows - Client, 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	ARM64 do Windows Server 2025

Códigos do Erro

Os códigos de erro são aplicáveis a todos os métodos 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 não foi encontrada.
415 - Tipo de mídia não suportado	O payload está em um formato sem suporte por esse método no recurso de destino.
422 - Entidade não processável	Falhas de validação.
429 - Excesso de solicitações	Muitos pedidos estão sendo enviados. As chamadas são limitadas e o tempo de retirada é 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 funcional.

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	O envio inicial já existe	Retornado quando um envio inicial é criado para um driver que já tem um envio inicial.
RequestInvalidForCurrentState	Não é possível criar um 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), pois 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 houve falha na fluxo de trabalho	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 do 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 para um produto que foi compartilhado (revendido), pois 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	Nenhum envio encontrado	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. IsAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems deve ser verdadeiro.	Retornado quando uma etiqueta de remessa de atualização do Windows para um INF de extensão é criada sem escolher isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems.
InvalidInput	As CHIDs são permitidas somente quando HardwareIds são para sistemas operacionais Windows 10 e posteriores.	Retornado quando uma etiqueta de remessa direcionada ao sistema operacional menor que o Windows 10 é criada com o direcionamento CHID. O direcionamento de CHID é aplicável apenas para 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 a etiqueta de remessa de publicação para a caixa de entrada ou o tipo de sistema. Só é possível compartilhar a etiqueta de remessa.	Retornado quando a etiqueta de remessa de atualização do Windows é 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 remessa. Aguarde um pouco e tente novamente.	Devolvido quando uma etiqueta de remessa é criada sem aguardar a conclusão da preparação ou do pré-processamento.

Confira também

Exemplos de API do painel de hardware (GitHub)

Compartilhar via

Obter dados do produto

Pré-requisitos

Recursos de dados

Recurso de produto

Recurso de envio

Objeto de Status do Fluxo de Trabalho

Baixar objeto

Objeto de link

Objeto de atributo adicional

Objeto StorageController

Objeto RaidController

Objeto SVVP

Lista de tipos de produtos

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

Lista de códigos do sistema operacional

Códigos do Erro

Confira também

Comentários

Recursos adicionais