제품 데이터 가져오기

아티클
09/12/2024

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

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

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

메서드	URI	설명
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/`	모든 제품에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}`	특정 제품에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions`	제품의 모든 제출에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}`	제품의 특정 제출에 대한 데이터 가져오기

필수 조건

이러한 메서드를 사용하기 전에 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	Long	제품의 개인 제품 ID
sharedProductId	Long	제품의 공유 제품 ID
링크	개체의 배열	자세한 내용은 링크 개체를 참조하세요.
isCommitted	Boolean	제품에 커밋된 제출이 하나 이상 있는지 여부를 나타냅니다.
isExtensionInf	Boolean	(사용되지 않음) 제품이 확장 드라이버인지 여부를 나타냅니다. 이 필드는 더 이상 사용되지 않으며 더 이상 사용되지 않아야 합니다. isExtensionInf가 제출 수준 속성으로 이동되었습니다.
deviceMetadataIds	GUID 배열	디바이스 메타데이터 제출을 드라이버에 매핑하는 GUID
deviceType	문자열	디바이스 유형을 나타냅니다. 가능한 값은 다음과 같습니다. "내부" - 내부 구성 요소, 디바이스는 시스템의 일부이며 PC 내부에 연결됩니다. "external" - 외부 구성 요소, 디바이스는 PC에 연결하는 외부 디바이스(주변 장치)입니다. "internalExternal" - 둘 다 디바이스를 내부(PC 내부) 및 외부(주변 장치)로 연결할 수 있습니다. "notSet" – 사용할 수 있는 데이터 없음
isTestSign	Boolean	제품이 테스트 서명된 드라이버인지 여부를 나타냅니다. 테스트 서명 드라이버 패키지에 대한 자세한 내용은 WHQL 테스트 서명 프로그램을 참조 하세요.
isFlightSign	Boolean	제품이 플라이트 서명 드라이버인지 여부를 나타냅니다. 비행 서명 드라이버는 Windows 업데이트 통해 게시 할 수있는 테스트 드라이버입니다. Windows 참가자 프로그램에 등록된 컴퓨터에서만 게시/설치할 수 있습니다. 보안 부팅을 사용하지 않도록 설정하지 않고 컴퓨터에 설치할 수 있습니다. Windows 참가자 프로그램에 속하지 않는 소매 컴퓨터에는 설치할 수 없습니다.
marketingNames	문자열 배열	제품의 마케팅 이름 또는 별칭
productName	문자열	만드는 동안 지정된 드라이버의 이름입니다.
selectedProductTypes	사전	둘 다 문자열인 키 값 쌍입니다. 키 는 운영 체제 패밀리 코드를 나타냅니다. 운영 체제 패밀리 코드 목록은 OS 패밀리 코드 목록을 참조 하세요. 값 은 제품의 형식을 나타냅니다. 제품 유형 목록은 제품 유형을 참조 하세요.
requestedSignatures	문자열 배열	제품이 인증된 운영 체제 서명 목록입니다. 모든 운영 체제 목록은 OS 코드 목록을 참조 하세요.
additionalAttributes	Object	자세한 내용은 추가 특성 개체를 참조 하세요.
testHarness	string	제출된 패키지의 유형입니다. 가능한 값은 다음과 같습니다. hlk hck 증명 notset
announcementDate	날짜/시간	제품이 Windows Server 카탈로그에 포함되는 날짜입니다.

제출 리소스

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

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

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

값	형식	설명
ID	long	제출의 ID
ProductId	long	이 제출이 연결된 개인 제품 ID
workflowstatus	개체	특정 제출의 세부 정보를 검색할 때만 사용할 수 있습니다. 이 개체는 이 제출에 대한 워크플로의 상태를 보여 줍니다. 자세한 내용은 워크플로 상태 개체를 참조 하세요.
링크	개체의 배열	자세한 내용은 링크 개체를 참조하세요.
commitStatus	자세한 내용은 제품 제출 관리를 참조하세요.
isExtensionInf	Boolean	제출이 확장 드라이버인지 여부를 나타냅니다.
isUniversal	Boolean	제출이 유니버설 API 테스트를 통과하는지 여부를 나타냅니다. 선언적 및 범용인 경우 드라이버가 DCHU 규격입니다.
isDeclarativeInf	Boolean	제출이 선언적 INVerif 테스트를 통과하는지 여부를 나타냅니다. 드라이버는 선언적이고 범용인 경우 DCHU 규격입니다.
속성	string	제출의 이름입니다.
Type	string	제출이 초기 또는 파생 제출인지 여부를 나타냅니다. 가능한 값은 다음과 같습니다. 최초의 파생
다운로드	개체	특정 제출의 세부 정보를 검색하는 경우에만 사용할 수 있습니다. 이 개체는 제출에 사용할 수 있는 다운로드를 보여 줍니다. 자세한 내용은 다운로드 개체를 참조 하세요.

Workflow Status 개체

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

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

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

값	형식	설명
currentStep	string	이 엔터티에 대한 전체 워크플로의 현재 단계 이름입니다. 수집/패키지 제출의 경우 가능한 값은 다음과 같습니다(괄호로 설명). packageInfoValidation(패키지 메타데이터 및 콘텐츠 유효성 검사) 준비(패키지 처리 준비) 검색(맬웨어에 대한 패키지 콘텐츠 검색) 유효성 검사(테스트 결과의 유효성 검사) catalogCreation(패키지에 대한 보안 카탈로그 만들기) manualReview(수동 검토 진행 중) 서명(이진 파일 서명) finalizeIngestion(수집 완료 및 서명된 파일 다운로드 또는 게시 준비)
State(상태)	string	현재 단계의 상태입니다. 가능한 값은 다음과 같습니다. notStarted 시작됨 실패 완료됨
메시지	배열	현재 단계에 대한 메시지를 제공하는 문자열 배열(특히 오류가 있는 경우)

개체 다운로드

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

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

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

값	형식	설명
아이템	배열	각각에 대한 다운로드 형식 및 URL의 배열입니다.
Type	string	다운로드할 수 있는 패키지의 유형입니다. 가능한 값은 다음과 같습니다. "initialPackage" – 사용자가 업로드한 패키지(새 제출의 경우 패키지 업로드를 위한 SAS URI를 가리킵니다). "derivedPackage" – 파생 제출에 대한 셸 "signedPackage" – Microsoft에서 서명한 패키지 "certificationReport" – 서명된 제품에 대한 인증 보고서 driverMetadata - 연결은 드라이버 메타데이터를 다운로드할 수 있는 파일을 가리킵니다. 자세한 내용은 드라이버 패키지 메타데이터를 참조하세요. ExternalNotes Unknown
메시지	배열	다운로드 가능한 파일에 대한 메시지를 제공하는 문자열 배열입니다.

링크 개체

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

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

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

값	형식	설명
Href	문자열	API를 통해 리소스에 액세스하는 URL
Rel (Rel)	문자열	리소스 유형입니다. 가능한 값은 다음과 같습니다. self – 링크가 자신을 가리킵니다. next_link – 페이지 매김에 일반적으로 사용되는 다음 리소스를 연결합니다. get_submissions – 제품의 모든 제출을 가리키는 링크 commit_submission – 제출 커밋을 위한 링크 지점 update_submission – 제출 업데이트에 대한 링크 지점 update_shippinglabel – 배송 레이블의 업데이트를 가리키는 링크
메서드	문자열	URL을 호출할 때 사용할 http 메서드의 형식입니다. 가능한 값은 다음과 같습니다. GET 게시 PATCH

추가 특성 개체

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

StorageController 개체

값	형식	설명
biosVersion	string	ROM Bios 버전
firmwareVersion	string	펌웨어 버전
driverVersion	string	드라이버 버전
driverName	string	드라이버 이름
deviceVersion	string	디바이스 버전
chipsetName	string	칩셋 이름
usedProprietary	부울 값	독점 드라이버를 통해 지원되는 다중 경로입니다. true이면 소유 이름 및 소유Version이 필수입니다.
proprietaryName	string	다중 경로 소프트웨어 이름
proprietaryVersion	string	다중 경로 소프트웨어 버전
usedMicrosoft	부울 값	Microsoft MPIO는 디바이스별 모듈을 통해 지원됩니다. true이면 microsoftName 및 microsoftVersion이 필수입니다.
microsoftName	string	다중 경로 소프트웨어 이름
microsoftVersion	string	다중 경로 소프트웨어 버전
usedBootSupport	부울 값	부팅 지원
usedBetterBoot	부울 값	부팅 > 2.2TB 지원. true이면 지원되는 UEFI 버전 및 지원되는 ACPI 버전이 필수입니다.
uefiVersion	string	지원되는 UEFI 버전
acpiVersion	string	지원되는 ACPI 버전
supportsSector4K512E	부울 값	4K/512e의 지원 섹터 크기
supportsSector4K4K	부울 값	4K/4K의 지원 섹터 크기
supportsDifferential	부울 값	차등(고전압 차등)

RaidController 개체

값	형식	설명
firmwareVersion	string	펌웨어 버전
filterVersion	string	드라이버 버전
driverVersion	string	필터 버전
usedProprietary	부울 값	독점 드라이버를 통해 지원되는 다중 경로입니다. true이면 소유 이름 및 소유Version이 필수입니다.
proprietaryName	string	다중 경로 소프트웨어 이름
proprietaryVersion	string	다중 경로 소프트웨어 버전
usedMicrosoft	부울 값	Microsoft MPIO는 디바이스별 모듈을 통해 지원됩니다. true이면 microsoftName 및 microsoftVersion이 필수입니다.
microsoftName	string	다중 경로 소프트웨어 이름
microsoftVersion	string	다중 경로 소프트웨어 버전
isThirdPartyNeeded	부울 값	연결에 필요한 비 Microsoft 드라이버
isSES	부울 값	SES(SCSI 엔클로저 서비스). SES가 포함되어 있는지를 나타냅니다. SCSI는 원래 소형 컴퓨터 시스템 인터페이스인 시스템의 디바이스를 연결하는 서비스 버스의 표준 용어입니다. SES는 SCSI 엔클로저 서비스의 약식입니다.
isSAFTE	부울 값	SAF-TE(ANBll 사양). SAF-TE가 포함되어 있는지를 나타냅니다. ANBll 산업 사양입니다. SAF-TE는 SCSI 액세스 내결함성 엔클로저의 약식입니다. SCSI는 원래 소형 컴퓨터 시스템 인터페이스인 시스템의 디바이스를 연결하는 서비스 버스의 표준 용어입니다.
additionalInfo	string	추가 정보

SVVP 개체

값	형식	설명
productVersion	string	제품 버전
supportLink	string	지원 URL
guestOs	string	게스트 OS. 가능한 값은 다음과 같습니다. Windows Server 2008 Windows Server 2008 릴리스 2 Windows Server 2012 Windows Server 2012 R2
processorArchitecture	string	하드웨어 프로세서 아키텍처. 가능한 값은 다음과 같습니다. 제온 시 Opteron Itanium 2
maxProcessors	정수	VM의 최대 프로세서
maxMemory	정수	VM의 최대 메모리(GB)

제품 유형 목록

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

3D 프린터
가속도계 센서
올인원
터치가 있는 All In One
오디오 디바이스
오디오 처리 개체
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 DisplayOnly
그래픽 어댑터 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
그래픽 태블릿
자이로스코프 센서
하드 드라이브
하드웨어 다기능 변환
Keyboard
키보드 비디오 마우스 전환
LAN
LAN(서버)
LAN CS
LAN 가상 머신(서버)
랩톱
터치를 사용하는 랩톱
LCD
광원 센서
위치 센서
Media Player
모바일 광대역 CDMA
모바일 광대역 GSM
휴대폰(Mobile Phone)
Monitor
마더보드
동작 센서 퓨전
다중 기능 프린터
근거리 근접
네트워크 미디어 디바이스
NFC
NFC 스마트 카드 판독기
광학 드라이브
펜 디지타이저
포인팅 그림
정밀터치패드
상태 센서
프린터
프로젝터
이동식 스토리지
라우터
스캐너
SDIO 컨트롤러
서버
서버 가상화 유효성 검사 프로그램
서명 태블릿
스마트 카드
스마트 카드 판독기
스토리지 배열
스토리지 컨트롤러
스토리지 공간 어댑터
스토리지 공간 드라이브
태블릿
터치
터치 모니터
TPM20
울트라 모바일 PC
터치를 사용하는 울트라 모바일 PC
USB 컨트롤러
USB 허브
WebCam
WLAN
WLAN CSB
WSD 다중 기능 프린터
WSD 프린터
WSD 스캐너

운영 체제 패밀리 코드 목록

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

OS 제품군 코드	설명
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 릴리스 2
WindowsServerSolutions	Windows Server 솔루션
Windows8	Windows 8
Windows8Server	Windows Server 2012
Windows81	Windows 8.1
Windows81Server	Windows Server 2012 R2
Windows_v100	Windows 10 임계값
Windows_v100Server	Windows Server Threshold
Windows_v100_RS1	Windows 10 1주년 업데이트
Windows_v100Server_RS1	Windows Server 2016
Windows_v100_RS2	Windows 10 RS2 업데이트
Windows_v100Server_RS2	Windows Server RS2
Windows_v100_RS3	Windows 10 RS3 업데이트
Windows_v100Server_RS3	Windows Server RS3
Windows_v100_RS4	Windows 10 RS4 업데이트
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 업데이트
Windows_v100_VB	Windows 10 버전 2004
Windows_v100Server_FE	Windows - 서버, 버전 21H2
Windows_v100_CO	Windows - 클라이언트 버전 21H2
Windows_v100_NI	Windows 11 클라이언트 버전 22H2
Windows_v100_GE	Windows 11 클라이언트 버전 24H2
Windows_v100Server_GE	Windows Server 2025

운영 체제 코드 목록

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

OS 코드	설명
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 미디어 센터
WINDOWS_2003	Windows Server 2003
WINDOWS_2003_IA64	Windows Server 2003 IA64
WINDOWS_2003_X64	Windows Server 2003 X64
WINDOWS_VISTA	Windows Vista 클라이언트
WINDOWS_VISTA_X64	Windows Vista 클라이언트 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	Windows 7 클라이언트
WINDOWS_7_X64	Windows 7 클라이언트 x64
WINDOWS_2008_SERVER_R2_IA64	Windows Server 2008 릴리스 2 IA64
WINDOWS_2008_SERVER_R2_X64	Windows Server 2008 릴리스 2 x64
WINDOWS_SERVER_SOLUTIONS_X64	Windows Server 솔루션 x64
WINDOWS_8	Windows 8 클라이언트
WINDOWS_8_X64	Windows 8 클라이언트 x64
WINDOWS_8_ARM	Windows 8 클라이언트 RT
WINDOWS_8_SERVER_X64	Windows Server 2012
WINDOWS_v63	Windows 8.1 클라이언트
WINDOWS_v63_X64	Windows 8.1 클라이언트 x64
WINDOWS_v63_ARM	Windows 8.1 클라이언트 RT
WINDOWS_v63_SERVER_X64	Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL	Windows 10 클라이언트 버전 1506 및 1511(TH1)
WINDOWS_v100_X64_TH1_FULL	Windows 10 클라이언트 버전 1506 및 1511 x64(TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL	Windows Server 2016 x64(TH1)
WINDOWS_v100_TH2_FULL	Windows 10 클라이언트 버전 1506 및 1511(TH2)
WINDOWS_v100_X64_TH2_FULL	Windows 10 클라이언트 버전 1506 및 1511 x64(TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL	Windows Server 2016 x64(TH2)
WINDOWS_v100_RS1_FULL	Windows 10 클라이언트 버전 1607
WINDOWS_v100_X64_RS1_FULL	Windows 10 클라이언트 버전 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL	Windows Server 2016 x64(RS1)
WINDOWS_v100_RS2_FULL	Windows 10 RS2 클라이언트
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 클라이언트 x64
WINDOWS_v100_RS3_FULL	Windows 10 RS3 클라이언트
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 클라이언트 x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 클라이언트 Arm64
WINDOWS_v100_RS4_FULL	Windows 10 RS4 클라이언트
WINDOWS_v100_X64_RS4_FULL	Windows 10 RS4 클라이언트 x64
WINDOWS_v100_ARM64_RS4_FULL	Windows 10 RS4 클라이언트 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 클라이언트 x64
WINDOWS_v100_19H1_FULL	Windows 19H1 클라이언트 x86
WINDOWS_v100_X64_19H1_FULL	Windows 19H1 클라이언트 x64
WINDOWS_v100_ARM64_19H1_FULL	Windows 19H1 클라이언트 Arm64
WINDOWS_v100_VB_FULL	Windows 10 버전 2004 클라이언트 x86
WINDOWS_v100_X64_VB_FULL	Windows 버전 2004 클라이언트 x64
WINDOWS_v100_ARM64_VB_FULL	Windows 버전 2004 클라이언트 Arm64
WINDOWS_v100_SERVER_X64_FE_FULL	Windows - Server 버전 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL	Windows - Server 버전 21H2 Arm64
WINDOWS_v100_X64_CO_FULL	Windows - 클라이언트 버전 21H2 x64
WINDOWS_v100_ARM64_CO_FULL	Windows - 클라이언트 버전 21H2 Arm64
WINDOWS_v100_X64_NI_FULL	Windows 11 클라이언트 버전 22H2 x64
WINDOWS_v100_ARM64_NI_FULL	Windows 11 클라이언트 버전 22H2 Arm64
WINDOWS_v100_X64_GE_FULL	Windows 11 클라이언트 버전 24H2 x64
WINDOWS_v100_ARM64_GE_FULL	Windows 11 클라이언트 버전 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL	Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL	Windows Server 2025 ARM64

오류 코드

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

HTTP 상태	설명
400 - 잘못된 요청	요청이 잘 구성되지 않음(예: 잘못된 형식의 요청 구문, 잘못된 요청 메시지 프레이밍 또는 기만적인 요청 라우팅)
401 - 권한 없음	인증 실패 또는 제공되지 않음
403 - 사용 권한 없음	리소스에 액세스할 수 없습니다.
404 – 찾을 수 없음	요청된 엔터티를 찾을 수 없습니다.
415 - 지원되지 않는 미디어 형식	페이로드는 대상 리소스에서 이 메서드에서 지원되지 않는 형식입니다.
422 - 처리할 수 없는 엔터티	유효성 검사 실패.
429 - 요청이 너무 많음	너무 많은 요청이 전송되고 있습니다. 호출이 제한되고 백오프 시간이 응답에 제공됩니다.
500 - 내부 서버 오류	API 서버에서 복구할 수 없는 오류가 발생했습니다.

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

오류 코드	오류 메시지	설명
InvalidInput		입력 유효성 검사가 실패할 때 반환됩니다.
RequestInvalidForCurrentState	보류 중인 제출만 커밋할 수 있습니다.	보류 중인 상태가 아닌 제출에 커밋이 적용되면 반환됩니다.
RequestInvalidForCurrentState	초기 제출이 이미 있음	초기 제출이 이미 있는 드라이버에 대해 초기 제출을 만들 때 반환됩니다.
RequestInvalidForCurrentState	초기 제출을 만들지 않았으므로 파생된 제출을 만들 수 없습니다.	초기 제출이 없는 드라이버에 대해 파생된 제출을 만들 때 반환됩니다.
UpdateUnauthorized	제품을 업데이트할 권한이 없음	공유 제품을 업데이트할 수 없으므로 공유(재판매)된 제품을 업데이트하려고 할 때 반환됩니다.
UpdateUnauthorized	초기 제출 없이 제품을 업데이트할 수 없습니다.	초기 제출이 없는 제품을 업데이트하려고 할 때 반환됩니다.
UpdateUnauthorized	워크플로가 실패하여 제품을 업데이트할 수 없습니다.	실패한 워크플로가 있는 제품을 업데이트하려고 할 때 반환됩니다.
UpdateUnauthorized	수집 프로세스가 완료된 후에는 공지 날짜를 업데이트할 수 없습니다.	수집이 완료된 후 공지 날짜가 업데이트될 때 반환됩니다.
UpdateUnauthorized	제품 이름은 현재 업데이트할 수 없습니다. 다시 시도하세요.
UpdateUnauthorized	제출을 업데이트할 권한이 없음	공유 제품을 업데이트할 수 없으므로 공유(재판매)된 제품에 대한 제출을 업데이트하려고 할 때 반환됩니다.
UpdateUnauthorized	워크플로가 실패했기 때문에 제출을 업데이트할 수 없습니다.	실패한 워크플로가 있는 제출을 업데이트하려고 할 때 반환됩니다.
EntityNotFound	제출을 찾을 수 없음	존재하지 않는 제출을 커밋하려고 할 때 반환됩니다.
EntityNotFound	제품을 찾을 수 없음	제품이 없는 제출을 만들 때 반환됩니다.
InvalidInput	확장 드라이버는 자동 업데이트로 게시해야 합니다. isAutoInstallDuringOSUpgrade 또는 isAutoInstallOnApplicableSystems 중 하나가 true여야 합니다.	isAutoInstallDuringOSUpgrade 또는 isAutoInstallOnApplicableSystems를 선택하지 않고 확장 INF에 대한 Windows 업데이트 배송 레이블을 만들 때 반환됩니다.
InvalidInput	CHID는 하드웨어 Id가 운영 체제 Windows 10 이상인 경우에만 허용됩니다.	CHID 대상 지정을 사용하여 WINDOWS 10보다 작은 OS를 대상으로 하는 배송 레이블을 만들 때 반환됩니다. CHID 대상 지정은 Windows 10 이상에만 적용됩니다.
InvalidInput	다른 워크플로가 진행 중인 경우 배송 레이블을 업데이트할 수 없습니다. 다시 시도하세요.	이전 워크플로가 아직 진행 중일 때 배송 레이블이 업데이트되면 반환됩니다.
RequestInvalidForCurrentState	받은 편지함 또는 시스템 유형에 대한 게시 배송 레이블을 만들 수 없습니다. 배송 레이블만 공유할 수 있습니다.	받은 편지함 드라이버 또는 시스템에서 Windows 업데이트 배송 레이블을 만들 때 반환됩니다.
RequestInvalidForCurrentState	제출은 아직 배송 레이블을 만들 준비가 되지 않았습니다. 잠시 후 다시 시도하세요.	준비 또는 전처리가 완료될 때까지 기다리지 않고 배송 레이블을 만들 때 반환됩니다.

참고 항목

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

다음을 통해 공유

제품 데이터 가져오기

필수 조건

데이터 리소스

제품 리소스

제출 리소스

Workflow Status 개체

개체 다운로드

링크 개체

추가 특성 개체

StorageController 개체

RaidController 개체

SVVP 개체

제품 유형 목록

운영 체제 패밀리 코드 목록

운영 체제 코드 목록

오류 코드

참고 항목

피드백

추가 리소스