Obter dados do produto

Use os seguintes métodos em APIs de hardware da Microsoft para recuperar 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 poder usar esses métodos, o produto já deve existir na sua conta do Centro de Desenvolvimento. Para criar ou gerenciar envios de produtos, consulte os métodos em Gerenciar envios de produtos.

Pré-requisitos

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

Este recurso representa um produto de hardware (driver) que está registrado na 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

Ferramenta de submissão

Este 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 tem os seguintes valores:

Objeto Estado do fluxo de trabalho

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

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

Este objeto tem os seguintes valores

Objeto de download

Este objeto representa os downloads para 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 tem os seguintes valores

Objeto Ligação

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

Objeto de Atributo adicional

Este 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

Objeto RaidController

Objeto SVVP

Lista de tipos de produtos

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

• Impressora 3D
• Sensor Acelerômetro
• Tudo em um
• O Tudo-em-um com Ecrã Tátil
• Dispositivo de áudio
• Objetos de processamento de áudio
• Controlador Bluetooth
• Controlador Bluetooth não USB
• Câmera
• Sensor de câmera
• Aglomerado
• Acelerador de computação MCDM 2.7
• Acelerador de computação MCDM 3.1
• Acelerador de computação MCDM 3.2
• Tablet conversível
• Versão desktop
• Renderizador de mídia digital
• Servidor de mídia digital
• Câmaras fotográficas digitais
• Câmaras 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 Apenas para Display
• Adaptador Gráfico WDDM2.0 Somente para Renderização
• Adaptador gráfico WDDM2.1
• Adaptador Gráfico WDDM2.1 Apenas para Ecrã
• Somente renderização do adaptador gráfico WDDM2.1
• Adaptador gráfico WDDM2.2
• Adaptador Gráfico Apenas para Ecrã WDDM2.2
• Adaptador Gráfico WDDM2.2 Somente para Renderização
• Adaptador gráfico WDDM2.3
• Apenas ecrã do adaptador gráfico WDDM2.3
• Adaptador Gráfico WDDM2.3 Apenas para Renderização
• Adaptador gráfico WDDM2.4
• Adaptador Gráfico WDDM2.4 Apenas para Ecrã
• Somente renderização do adaptador gráfico WDDM2.4
• Adaptador gráfico WDDM2.4 VM
• Adaptador gráfico WDDM2.5
• Apenas visualização do adaptador gráfico WDDM2.5
• Adaptador Gráfico WDDM2.5 Apenas para Renderização
• Adaptador gráfico WDDM2.5 VM
• Adaptador gráfico WDDM2.6
• Adaptador Gráfico WDDM2.6 Apenas para Ecrã
• Adaptador Gráfico WDDM2.6 Apenas para Renderização
• Adaptador gráfico WDDM2.6 VM
• Adaptador gráfico WDDM2.7
• Apenas ecrã do adaptador gráfico WDDM2.7
• Adaptador Gráfico WDDM2.7 Somente para Renderização
• Adaptador gráfico WDDM2.7 VM
• Adaptador gráfico WDDM2.8
• Apenas ecrã do adaptador gráfico WDDM2.8
• Somente renderização do adaptador gráfico WDDM2.8
• Adaptador gráfico WDDM2.8 VM
• Adaptador gráfico WDDM2.9
• Apenas ecrã do adaptador gráfico WDDM2.9
• Somente renderização do adaptador gráfico WDDM2.9
• Adaptador gráfico WDDM2.9 VM
• Adaptador gráfico WDDM3.0
• Apenas ecrã do adaptador gráfico WDDM3.0
• Somente renderização do adaptador gráfico WDDM3.0
• Adaptador gráfico WDDM3.0 VM
• Adaptador gráfico WDDM3.1
• Apenas ecrã do adaptador gráfico WDDM3.1
• Apenas renderização do adaptador gráfico WDDM3.1
• Adaptador gráfico WDDM3.1 VM
• Adaptador gráfico WDDM3.2
• Apenas ecrã do adaptador gráfico WDDM3.2
• Adaptador gráfico WDDM3.2 Apenas de renderização
• Adaptador gráfico WDDM3.2 VM
• Tablet gráfico
• Sensor de giroscópio
• Disco rígido
• Transformações multifuncionais de hardware
• Teclado
• Comutador de Teclado, Vídeo e Rato
• Rede Local (LAN)
• LAN (Servidor)
• LAN CS
• Máquina virtual LAN (servidor)
• Computador portátil
• Laptop com toque
• Ecrã de Cristal Líquido (LCD)
• Sensor de luz
• Sensor de Localização
• leitor de multimédia
• CDMA de Banda Larga Móvel
• GSM de banda larga móvel
• Telemóvel
• Ecrã
• Placa-mãe
• Fusão de sensores de movimento
• Impressora multifunções
• Proximidade perto do campo
• Dispositivo de mídia de rede
• NFC
• Leitor de cartões inteligentes NFC
• Unidade ótica
• Digitalizador de caneta
• Apontando desenho
• PrecisionTouchpad
• Sensor de Presença
• Impressora
• Projetor
• Armazenamento Removível
• Roteador
• Digitalizador
• Controlador SDIO
• Servidor
• Programa de Validação de Virtualização de Servidor
• Tablet de assinatura
• Cartões inteligentes
• Leitor de Smartcard
• Array de armazenamento
• Controlador de armazenamento
• Adaptador de Espaços de Armazenamento
• Unidade de Espaços de Armazenamento
• Tablet
• Toque
• Monitor Táctil
• TPM20
• Computador Ultra-Móvel
• Ultra-Mobile PC com ecrã tátil
• Controlador USB
• USB Hub
• WebCam
• WLAN
• LAN sem fios CSB
• Impressora multifunções WSD
• Impressora WSD
• WSD Digitalizador

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

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

Lista de códigos do sistema operacional

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

Códigos de erro

Os códigos de erro são aplicáveis a todos os métodos 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.

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

Ver também

• Exemplos de API do dashboard de hardware (GitHub)