제품 데이터 가져오기

Microsoft 하드웨어 API에서 다음 방법을 사용하여 개발자 센터 계정에 등록된 하드웨어 제품의 데이터를 검색합니다. API를 사용하기 위한 필수 구성 요소를 포함하여 Microsoft 하드웨어 API에 대한 소개는 API를 사용하여 하드웨어 제출 관리를 참조 하세요.

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

이러한 방법을 사용하려면 먼저 제품이 개발자 센터 계정에 이미 있어야 합니다. 제품에 대한 제출을 만들거나 관리하려면 제품 제출 관리의 방법을 참조하세요.

필수 조건

이러한 메서드를 사용하기 전에 Microsoft 하드웨어 API에 대한 모든 필수 구성 요소를 완료합니다.

데이터 리소스

제품 데이터를 가져오기 위한 Microsoft 하드웨어 API 메서드는 다음 JSON 데이터 리소스를 사용합니다.

제품 리소스

이 리소스는 계정에 등록된 하드웨어 제품(드라이버)을 나타냅니다.

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

이 리소스의 값은 다음과 같습니다.

제출 리소스

이 리소스는 제품의 제출을 나타냅니다.

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

이 리소스의 값은 다음과 같습니다.

Workflow Status 개체

이 개체는 지정된 엔터티의 워크플로 상태를 나타냅니다.

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

이 개체의 값은 다음과 같습니다.

개체 다운로드

이 개체는 지정된 제출에 대한 다운로드를 나타냅니다.

{
  "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": []
}

이 개체의 값은 다음과 같습니다.

링크 개체

이 개체는 포함하는 엔터티에 대한 유용한 링크 목록을 나타냅니다.

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

이 개체의 값은 다음과 같습니다.

추가 특성 개체

이 개체는 RAID 컨트롤러, 스토리지 컨트롤러 또는 SVVP(서버 가상화 유효성 검사 프로그램) 유형인 경우 제품에 대한 더 많은 특성을 제공합니다. StorageController, RaidController 또는 SVVP의 세 가지 개체 유형 중 하나를 포함할 수 있습니다.

StorageController 개체

RaidController 개체

SVVP 개체

제품 유형 목록

제품은 다음과 같은 유형일 수 있습니다. 운영 체제와 함께 이 정보는 적용 가능성을 식별하는 데 사용됩니다.

• 3D 프린터
• 가속도계 센서
• 올인원
• 올인원 터치 시스템
• 오디오 디바이스
• 오디오 처리 개체
• Bluetooth 컨트롤러
• Bluetooth 컨트롤러 USB가 아님
• 카메라
• 카메라 센서
• 클러스터
• Compute Accelerator MCDM 2.7
• Compute Accelerator MCDM 3.1
• Compute Accelerator MCDM 3.2
• 변환 가능 태블릿
• 바탕 화면
• 디지털 미디어 렌더러
• 디지털 미디어 서버
• 디지털 스틸 카메라
• 디지털 비디오 카메라
• 배포 스캔 관리가 활성화된 디바이스
• 엔터프라이즈 WSD 다중 기능 프린터
• 지문 판독기
• 게임 컨트롤러
• 일반 컨트롤러
• 일반 휴대용 디바이스
• 그래픽 어댑터 MCDM2.7
• 그래픽 어댑터 MCDM2.8
• 그래픽 어댑터 MCDM2.9
• 그래픽 어댑터 MCDM3.0
• 그래픽 어댑터 WDDM1.0
• 그래픽 어댑터 WDDM1.1
• 그래픽 어댑터 WDDM1.2
• 그래픽 어댑터 WDDM1.2 디스플레이 전용
• 그래픽 어댑터 WDDM1.2 RenderOnly
• 그래픽 어댑터 WDDM1.3
• 그래픽 어댑터 "WDDM1.3 DisplayOnly"
• 그래픽 어댑터 WDDM1.3 RenderOnly
• 그래픽 어댑터 WDDM2.0
• 표시 전용 그래픽 어댑터 WDDM2.0
• 그래픽 어댑터 WDDM2.0 렌더링 전용
• 그래픽 어댑터 WDDM2.1
• 그래픽 어댑터 WDDM2.1 디스플레이 전용
• 그래픽 어댑터 WDDM2.1 렌더링 전용
• 그래픽 어댑터 WDDM2.2
• 그래픽 어댑터 WDDM2.2 디스플레이 전용
• 그래픽 어댑터 WDDM2.2 렌더링 전용
• 그래픽 어댑터 WDDM2.3
• 그래픽 어댑터 WDDM2.3 디스플레이 전용
• 그래픽 어댑터 WDDM2.3 렌더링 전용
• 그래픽 어댑터 WDDM2.4
• 그래픽 어댑터 WDDM2.4 디스플레이 전용
• 그래픽 어댑터 WDDM2.4 렌더링 전용
• 그래픽 어댑터 WDDM2.4 VM
• 그래픽 어댑터 WDDM2.5
• 디스플레이 전용 그래픽 어댑터 WDDM2.5
• 그래픽 어댑터 WDDM2.5 렌더링 전용
• 그래픽 어댑터 WDDM2.5 VM
• 그래픽 어댑터 WDDM2.6
• 그래픽 어댑터 WDDM2.6 디스플레이 전용
• 그래픽 어댑터 WDDM2.6 렌더링 전용
• 그래픽 어댑터 WDDM2.6 VM
• 그래픽 어댑터 WDDM2.7
• 그래픽 어댑터 WDDM2.7 표시 전용
• 그래픽 어댑터 WDDM2.7 렌더링 전용
• 그래픽 어댑터 WDDM2.7 VM
• 그래픽 어댑터 WDDM2.8
• 그래픽 어댑터 WDDM2.8 표시만
• 그래픽 어댑터 WDDM2.8 렌더링 전용
• 그래픽 어댑터 WDDM2.8 VM
• 그래픽 어댑터 WDDM2.9
• 그래픽 어댑터 WDDM2.9 디스플레이 전용
• 그래픽 어댑터 WDDM2.9 렌더링 전용
• 그래픽 어댑터 WDDM2.9 VM
• 그래픽 어댑터 WDDM3.0
• 그래픽 어댑터 WDDM3.0 디스플레이 전용
• 그래픽 어댑터 WDDM3.0 렌더링 전용
• 그래픽 어댑터 WDDM3.0 VM
• 그래픽 어댑터 WDDM3.1
• 그래픽 어댑터 WDDM3.1 디스플레이 전용
• 그래픽 어댑터 WDDM3.1 렌더링 전용
• 그래픽 어댑터 WDDM3.1 VM
• 그래픽 어댑터 WDDM3.2
• 그래픽 어댑터 WDDM3.2 디스플레이 전용
• 그래픽 어댑터 WDDM3.2 렌더링 전용
• 그래픽 어댑터 WDDM3.2 VM
• 그래픽 태블릿
• 자이로스코프 센서
• 하드 드라이브
• 하드웨어 다기능 변형
• 키보드
• 키보드 비디오 마우스 전환
• 랜
• LAN(서버)
• LAN CS
• LAN 가상 머신(서버)
• 랩톱
• 터치를 사용하는 랩톱
• 액정 디스플레이
• 광원 센서
• 위치 센서
• 미디어 플레이어
• 모바일 광대역 CDMA
• 모바일 광대역 GSM
• 휴대폰(Mobile Phone)
• 모니터
• 마더보드
• 동작 센서 퓨전
• 다중 기능 프린터
• 근거리 근접
• 네트워크 미디어 디바이스
• NFC
• NFC 스마트 카드 판독기
• 광학 드라이브
• 펜 디지타이저
• 지시하는 그림
• 정밀터치패드
• 존재 감지 센서
• 프린터
• 프로젝터
• 이동식 스토리지
• 라우터
• 스캐너
• SDIO 컨트롤러
• 서버
• 서버 가상화 유효성 검사 프로그램
• 서명 태블릿
• 스마트 카드
• 스마트 카드 판독기
• 스토리지 배열
• 스토리지 컨트롤러
• 스토리지 공간 어댑터
• 스토리지 공간 드라이브
• 태블릿
• 터치
• 터치 모니터
• TPM20
• 울트라 모바일 PC
• 터치를 사용하는 울트라 모바일 PC
• USB 컨트롤러
• USB 허브
• WebCam
• WLAN
• WLAN CSB
• WSD 다중 기능 프린터
• WSD 프린터
• WSD 스캐너

운영 체제 패밀리 코드 목록

다음 표에는 운영 체제 패밀리 코드 및 해당 설명이 나와 있습니다.

운영 체제 코드 목록

다음 표에는 운영 체제 코드 및 해당 설명이 나와 있습니다.

오류 코드

오류 코드는 API의 모든 웹 메서드에 적용할 수 있습니다. 요청을 성공적으로 완료할 수 없는 경우 응답에는 다음 HTTP 오류 코드 중 하나가 포함됩니다.

기능 유효성 검사 실패가 있는 경우 응답 본문에는 다음 기능 오류 코드 중 하나가 포함됩니다.

참고 항목

• 하드웨어 대시보드 API 샘플(GitHub)