제품 데이터 가져오기

아티클
01/10/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/hardware/products/`	모든 제품에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}`	특정 제품에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions`	제품의 모든 제출에 대한 데이터 가져오기
GET	`https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions/{submissionId}`	제품의 특정 제출에 대한 데이터 가져오기

사전 요구 사항

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

데이터 리소스

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

제품 리소스

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

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

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

값	형식	설명
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	Datetime	제품이 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	object	특정 제출의 세부 정보를 검색할 때만 사용할 수 있습니다. 이 개체는 이 제출에 대한 워크플로의 상태 보여 줍니다. 자세한 내용은 워크플로 상태 개체를 참조하세요.
링크	개체의 배열	자세한 내용은 링크 개체 를 참조하세요.
commitStatus	자세한 내용은 제품 제출 관리를 참조하세요.
isExtensionInf	Boolean	제출이 확장 드라이버인지 여부를 나타냅니다.
isUniversal	Boolean	제출이 유니버설 API 테스트를 통과하는지 여부를 나타냅니다. 드라이버는 10진수 및 범용인 경우 DCHU 규격입니다.
isDeclarativeInf	Boolean	제출이 선언적 INVerif 테스트를 통과하는지 여부를 나타냅니다. 드라이버는 10진수 및 범용인 경우 DCHU 규격입니다.
이름	string	제출의 이름
Type	문자열	제출이 초기 또는 파생 제출인지 여부를 나타냅니다. 가능한 값은 아래와 같습니다. initial 파생
다운로드	object	특정 제출의 세부 정보를 검색하는 경우에만 사용할 수 있습니다. 이 개체는 제출에 사용할 수 있는 다운로드를 보여 줍니다. 자세한 내용은 다운로드 개체 를 참조하세요.

Workflow Status 개체

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

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

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

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

개체 다운로드

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

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

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

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

Link 개체

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

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

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

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

추가 Attribute 개체

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

StorageController 개체

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

RaidController 개체

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

SVVP 개체

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

제품 유형 목록

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

올인원
터치가 있는 모든 인원
오디오 디바이스
Bluetooth 컨트롤러
Bluetooth 컨트롤러 비 USB
변환 가능 태블릿
데스크톱
디지털 미디어 렌더러
디지털 미디어 서버
디지털 스틸 카메라
디지털 비디오 카메라
배포 검사 관리 사용 디바이스
엔터프라이즈 WSD 다중 기능 프린터
지문 판독기
게임 컨트롤러
일반 컨트롤러
일반 휴대용 디바이스
그래픽 어댑터 WDDM1.0
그래픽 어댑터 WDDM1.1
그래픽 어댑터 WDDM1.2
그래픽 어댑터 WDDM1.2 DisplayOnly
그래픽 어댑터 WDDM1.2 RenderOnly
그래픽 태블릿
하드 드라이브
Keyboard
키보드 비디오 마우스 전환
LAN
LAN(서버)
LAN CS
LAN 가상 머신(서버)
랩톱
터치를 사용하는 랩톱
LCD
광원 센서
위치 센서
Media Player
모바일 광대역 CDMA
모바일 광대역 GSM
휴대폰
Monitor
마더보드
동작 센서 퓨전
다중 기능 프린터
근거리 근접
네트워크 미디어 디바이스
광학 드라이브
펜 디지타이저
포인팅 그림
상태 센서
프린터
Projector
이동식 스토리지
라우터
스캐너
SDIO 컨트롤러
서버
서버 가상화 유효성 검사 프로그램
서명 태블릿
Smart Cards
스마트 카드 판독기
스토리지 배열
스토리지 컨트롤러
스토리지 공간 어댑터
스토리지 공간 드라이브
태블릿
터치
터치 모니터
울트라 모바일 PC
터치를 사용하는 울트라 모바일 PC
USB 컨트롤러
USB 허브
WebCam
WLAN
WLAN CSB
WSD 다중 기능 프린터
WSD 프린터
WSD 스캐너

운영 체제 패밀리 코드 목록

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

OS 제품군 코드	Description
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	RS2 업데이트 Windows 10
Windows_v100Server_RS2	Windows Server RS2
Windows_v100_RS3	RS3 업데이트 Windows 10
Windows_v100Server_RS3	Windows Server RS3
Windows_v100_RS4	RS4 업데이트 Windows 10
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

운영 체제 코드 목록

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

OS 코드	Description
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	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 Solutions 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	RS2 클라이언트 Windows 10
WINDOWS_v100_X64_RS2_FULL	Windows 10 RS2 클라이언트 x64
WINDOWS_v100_RS3_FULL	RS3 클라이언트 Windows 10
WINDOWS_v100_X64_RS3_FULL	Windows 10 RS3 클라이언트 x64
WINDOWS_v100_ARM64_RS3_FULL	Windows 10 RS3 클라이언트 Arm64
WINDOWS_v100_RS4_FULL	RS4 클라이언트 Windows 10
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 - 서버 버전 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL	Windows - 서버 버전 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

오류 코드

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

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

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

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

추가 정보

하드웨어 dashboard API 샘플(GitHub)

제품 데이터 가져오기

사전 요구 사항

데이터 리소스

제품 리소스

제출 리소스

Workflow Status 개체

개체 다운로드

Link 개체

추가 Attribute 개체

StorageController 개체

RaidController 개체

SVVP 개체

제품 유형 목록

운영 체제 패밀리 코드 목록

운영 체제 코드 목록

오류 코드

추가 정보

피드백

피드백

추가 리소스