다음을 통해 공유


제품 데이터 가져오기

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 제출은 아직 배송 레이블을 만들 준비가 되지 않았습니다. 잠시 후 다시 시도하세요. 준비 또는 전처리가 완료될 때까지 기다리지 않고 배송 레이블을 만들 때 반환됩니다.

참고 항목