Obter dados do produto

Artigo
06/15/2023

Use os métodos a seguir nas APIs de Hardware da Microsoft para obter dados para 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 para 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/`	Obter 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 fez 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 do 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",
}

Esse recurso tem os seguintes valores

Valor	Tipo	Descrição
ID	long	A ID do produto privado do produto
sharedProductId	long	A ID do produto compartilhado do produto
Links	matriz de objetos	Consulte o objeto 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 do dispositivo para o driver
deviceType	Cadeia de caracteres	Indica o tipo de dispositivo. Os valores possíveis são: "interno" – um componente interno, o dispositivo faz parte de um sistema e se conecta dentro do computador "externo" – um componente externo, o dispositivo é um dispositivo externo (periférico) que se conecta a um computador "internalExternal" – Ambos, o dispositivo pode ser conectado internamente (dentro de um computador) e externamente (periférico) "notSet" – nenhum dado disponível
isTestSign	Booliano	Indica se o produto é um driver assinado por teste. Para obter mais informações sobre pacotes de driver de assinatura de teste, confira Programa de Assinatura de Teste do WHQL
isFlightSign	Booliano	Indica se o produto é um driver com sinal de voo. Os motoristas com sinal de voo são drivers de teste que podem ser publicados por meio de Windows Update. Eles podem ser publicados/instalados somente em computadores que se inscreveram no Programa Windows Insider. Eles podem ser instalados em computadores 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.
marketingNames	Matriz de cadeias de caracteres	Nomes de marketing ou aliases do produto
productName	Cadeia de caracteres	O nome do driver conforme especificado durante a criação
selectedProductTypes	dicionário	Par de valores de chave em que ambas são cadeias de caracteres. Key representa o Código de Família do Sistema Operacional. Para obter uma lista de Códigos de Família do Sistema Operacional, consulte a lista de códigos de família do sistema operacional. Value 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 a lista de códigos do sistema operacional
additionalAttributes	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 atestado Notset
announcementDate	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"
}

Esse recurso tem os seguintes valores:

Valor	Tipo	Descrição
ID	long	A ID do envio
Productid	long	A ID do produto privado à qual esse envio está associado
Workflowstatus	objeto	Isso só está disponível ao recuperar detalhes de um envio específico. Esse objeto ilustra a status do fluxo de trabalho para esse envio. Consulte o objeto status de fluxo de trabalho para obter mais detalhes
Links	matriz de objetos	Consulte o objeto 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 será compatível com DCHU se for Decalarative e Universal
isDeclarativeInf	Booliano	Indica se o envio passa no teste DECLARAtivo INVerif. Um driver será compatível com DCHU se for Decalarative e Universal
Nome	cadeia de caracteres	O nome do envio
Type	string	Indica se o envio é um envio inicial ou derivado. Os valores possíveis são: inicial derivado
downloads	objeto	Isso só está disponível ao recuperar detalhes de um envio específico. Esse objeto ilustra 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 a status do fluxo de trabalho para uma determinada entidade

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

Esse objeto tem os seguintes valores

Valor	Tipo	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) preparação (Preparando o pacote para processamento) verificação (verificação do conteúdo do pacote para Malware) validação (validação dos resultados do teste) catalogCreation (Criando um catálogo de segurança para o pacote) manualReview (passando por revisão manual) assinatura (assinando os binários) finalizeIngestion (concluindo a ingestão e preparando 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	array	Uma matriz de cadeias de caracteres para fornecer mensagens sobre a etapa atual (especialmente em caso de falha)

Baixar objeto

Esse objeto representa os downloads de um determinado envio.

{
  "items": [
    {
      "type": "initialPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/dc55b8c6-a01c-40b6-b815-cac8bc08812a?sv=2016-05-31&sr=b&sig=ipjW3RsVC75lZrcEZRh9JmTX89L4gTIKkxwqv9F8Axs%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "type": "derivedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/6bd77dbf-a851-46d2-b703-29ea4efae006?sv=2016-05-31&sr=b&sig=O5XQf%2FzMbI2FFt5WwSUJWL1JbWY4JXXPRkCKAnX7IRs%3D&se=2018-03-12T15:32:10Z&sp=rl&rscd=attachment%3B filename%3DShell_1152921504621441930.hlkx"
    },
    {
      "type": "signedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/0b83a294-c1d1-4136-82a1-dd52f51841e3?sv=2016-05-31&sr=b&sig=zTfxKJmaTwpbFol%2FpAKG0QuXJTTxm5aZ0F2wQQI8whc%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "type": "certificationReport",
      "url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
    }
  ],
  "messages": []
}

Esse objeto tem os seguintes valores

Valor	Tipo	Descrição
Itens	array	Uma matriz de tipos de download e a URL para cada um. 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 (no caso de novo envio, ele aponta para o URI de SAS para carregar o pacote) "derivedPackage" – shell para envios derivados "signedPackage" – pacote assinado pela Microsoft "certificationReport" – relatório de certificação para o produto assinado driverMetadata - o link aponta para um arquivo que permite o download de metadados do driver. Para obter mais detalhes, consulte metadados do pacote de driver. ExternalNotes Unknown
Mensagens	array	Uma matriz de cadeias de caracteres para fornecer mensagens sobre os arquivos baixáveis

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

Esse objeto tem os seguintes valores

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

Objeto Attribute adicional

Esse 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	Tipo	Descrição
biosVersion	string	Versão do 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
chipsetName	string	Nome do chipset
usedProprietary	booleano	Suporte a vários caminhos por meio do driver proprietário. Se for true, proprietaryName e proprietaryVersion serão madatory
proprietaryName	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão de software de vários caminhos
usedMicrosoft	booleano	O Microsoft MPIO tem suporte por meio do módulo específico do dispositivo. Se for true, microsoftName e microsoftVersion serão madatory
microsoftName	string	Nome do software de vários caminhos
microsoftVersion	string	Versão de software de vários caminhos
usedBootSupport	booleano	Suporte à inicialização
usedBetterBoot	booleano	Suporte ao Boot >2.2TB. Se true, a versão do UEFI com suporte e a versão do ACPI com suporte são obrigatórias
uefiVersion	string	Versão uefi com suporte
acpiVersion	string	Versão do ACPI com suporte
supportsSector4K512E	booleano	Tamanho do setor de suporte de 4K/512e
supportsSector4K4K	booleano	Tamanho do setor de suporte de 4K/4K
supportsDifferential	booleano	Diferencial (diferencial de alta tensão)

Objeto RaidController

Valor	Tipo	Descrição
firmwareVersion	string	Versão do Firmware
filterVersion	string	Versão do driver
driverVersion	string	Filtrar Versão
usedProprietary	booleano	Multicamadas com suporte por meio de driver proprietário. Se for true, proprietaryName e proprietaryVersion serão obrigatórios
proprietaryName	string	Nome do software de vários caminhos
proprietaryVersion	string	Versão de software de vários caminhos
usedMicrosoft	booleano	O Microsoft MPIO tem suporte por meio do módulo específico do dispositivo. Se for true, microsoftName e microsoftVersion serão obrigatórios
microsoftName	string	Nome do software de vários caminhos
microsoftVersion	string	Versão de software de vários caminhos
isThirdPartyNeeded	booleano	Driver não Microsoft de terceiros necessário para conectividade
isSES	booleano	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. A SES é abreviada para Serviços de Compartimento SCSI.
isSAFTE	booleano	SAF-TE (Especificação ANBll). Indica se um SAF-TE está incluído. ANBll uma especificação do setor. SAF-TE é abreviação de Compartimentos Tolerantes a Falhas Acessados por SCSI. 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	Tipo	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	inteiro	Processadores máximos na VM
maxMemory	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.

Tudo em Um
Tudo em um com toque
Dispositivo de áudio
Controlador Bluetooth
Controlador Bluetooth não USB
Tablet Conversível
Área de Trabalho
Renderizador de Mídia Digital
Servidor de Mídia Digital
Câmeras ParaDos Digitais
Câmeras de vídeo digital
Dispositivos habilitados para gerenciamento de verificação de distribuição
Impressora de várias funções WSD corporativa
Leitor de Impressão digital
Controlador de jogo
Controlador genérico
Dispositivo portátil genérico
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
Tablet gráfico
Disco Rígido
Keyboard
Comutador de Mouse de Vídeo de Teclado
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
CDMA de Banda Larga Móvel
GSM de Banda Larga Móvel
Telefone celular
Monitor
Placa-mãe
Motion Sensor Fusion
Impressora de várias funções
Proximidade do campo próximo
Dispositivo de Mídia de Rede
Unidade óptica
Digitalizador de Caneta
Desenho apontando
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
Smart Cards
Leitor de cartão inteligente
Matriz de Armazenamento
Controlador de Armazenamento
Adaptador Espaços de Armazenamento
unidade de Espaços de Armazenamento
Tablet
Touch
Monitor de Toque
computador Ultra-Mobile
Ultra-Mobile computador com Touch
Controlador USB
Hub USB
Webcam
WLAN
WLAN CSB
Impressora de várias funções do WSD
Impressora WSD
WSD Scanner

Lista de códigos de família do sistema operacional

A tabela a seguir lista códigos de família do sistema operacional e suas descrições.

Código da 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	Soluções do Windows Server
Windows8	Windows 8
Windows8Server	Windows Server 2012
Windows81	Windows 8.1
Windows81Server	Windows Server 2012 R2
Windows_v100	Limite de 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	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	Atualização 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	cliente Windows 11, versão 22H2

Lista de códigos do sistema operacional

A tabela a seguir lista 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	Windows Server 2003 IA64
WINDOWS_2003_X64	Windows Server 2003 X64
WINDOWS_VISTA	Cliente do Windows Vista
WINDOWS_VISTA_X64	Windows Vista Client 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 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	Soluções do Windows Server 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 versões do cliente 1506 e 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL	Windows 10 versões 1506 e 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL	Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL	Windows 10 versões do cliente 1506 e 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL	Windows 10 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 Windows 10 RS2
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 Client x64
WINDOWS_v100_RS3_FULL	Cliente Windows 10 RS3
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 Client x64
WINDOWS_v100_ARM64_RS3_FULL	arm64 do cliente Windows 10 RS3
WINDOWS_v100_RS4_FULL	cliente Windows 10 RS4
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 Client x64
WINDOWS_v100_ARM64_RS4_FULL	arm64 do cliente Windows 10 RS4
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 – 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

Códigos do Erro

Os códigos de erro são aplicáveis a todos os métodos Web da API. Se não for possível concluir a solicitação, 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 sem suporte	A carga está em um formato sem suporte por esse método no recurso de destino.
422 – Entidade não processável	Falhas de validação.
500 – Erro interno do servidor	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 do Erro	Mensagem de erro	Descrição
InvalidInput		Retornado quando uma validação de entrada falha
RequestInvalidForCurrentState	Somente envios pendentes podem ser confirmados	Retornado quando um commit é aplicado 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 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 o fluxo de trabalho falhou	Retornado ao tentar atualizar um produto que tem um fluxo de trabalho com falha
UpdateUnauthorized	A Data de 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 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. Um dos isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems deve ser true.	Retornado quando uma etiqueta de envio do Windows Update para uma extensão INF é criada sem escolher isAutoInstallDuringOSUpgrade ou isAutoInstallOnApplicableSystems
InvalidInput	Os chids são permitidos somente quando HardwareIds são para sistemas operacionais Windows10 & Acima.	Retornado quando uma etiqueta de remessa direcionada ao sistema operacional menor que o Windows 10 é criada com direcionamento CHID. A segmentação CHID é aplicável somente para Windows 10 e superiores.
InvalidInput	Não é possível atualizar o rótulo de envio 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 o rótulo de envio de publicação para tipo de sistema ou caixa de entrada. Só é possível compartilhar a etiqueta de remessa.	Retornado quando o rótulo de envio do Windows Update é criado em um driver de caixa de entrada ou em um sistema.
RequestInvalidForCurrentState	O envio ainda não está pronto para criar uma etiqueta de envio. Tente novamente mais tarde.	Retornado quando uma etiqueta de remessa é criada sem aguardar a conclusão da preparação ou pré-processamento.

Confira também

exemplos de API de hardware dashboard (GitHub)

Share via

Obter dados do produto

Pré-requisitos

Recursos de dados

Recurso do produto

Recurso de envio

Objeto Status do Fluxo de Trabalho

Baixar objeto

Objeto Link

Objeto Attribute adicional

Objeto StorageController

Objeto RaidController

Objeto SVVP

Lista de tipos de produtos

Lista de códigos de família do sistema operacional

Lista de códigos do sistema operacional

Códigos do Erro

Confira também

Comentários

Comentários

Recursos adicionais