Obter dados do produto

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.

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

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:

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

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

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

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

Objeto RaidController

Objeto SVVP

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.

Lista de códigos do sistema operacional

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

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.

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

Confira também

• Exemplos de API do painel de hardware (GitHub)