Sdílet prostřednictvím


Získání dat o produktech

Pomocí následujících metod v rozhraních Microsoft Hardware API načtěte data pro hardwarové produkty zaregistrované ve vašem účtu Dev Center. Úvod k hardwarovým rozhraním API Microsoftu, včetně požadavků na používání rozhraní API, najdete v tématu Správa odesílání hardwaru pomocí rozhraní API.

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

Než budete moct tyto metody použít, musí už produkt existovat ve vašem účtu Dev Center. Pokud chcete vytvářet nebo spravovat odesílání produktů, podívejte se na metody v části Správa odesílání produktů.

Metoda identifikátor URI Popis
ZÍSKAT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ Získání dat pro všechny vaše produkty
ZÍSKAT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Získání dat pro konkrétní produkt
ZÍSKAT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions Získání dat pro všechna odeslání produktu
ZÍSKAT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Získání dat pro konkrétní odeslání produktu

Požadavky

Než se pokusíte použít některou z těchto metod, dokončete všechny požadavky na hardwarová rozhraní API microsoftu.

Datové prostředky

Metody rozhraní MICROSOFT Hardware API pro získání dat o produktech používají následující datové zdroje JSON.

Zdroj produktu

Tento prostředek představuje hardwarový produkt (ovladač), který je zaregistrovaný ve vašem účtu.

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

Tento prostředek má následující hodnoty.

Hodnota Typ Popis
identifikátor Dlouhý soukromé ID produktu
sdílenéProduktovéID Dlouhý ID sdíleného produktu
Odkazy pole objektů Další podrobnosti najdete v objektu odkazu.
jeZavázáno logický Určuje, jestli má produkt alespoň jedno potvrzené odeslání.
isExtensionInf logický (ZASTARALÉ) Určuje, jestli je produkt ovladačem rozšíření. Toto pole je zastaralé a už by se nemělo používat. isExtensionInf se přesunul na vlastnost úrovně odeslání.
deviceMetadataIds pole GUIDů Identifikátory GUID, které mapují odesílání metadat zařízení do ovladače
typ zařízení Řetězec Určuje typ zařízení. Možné hodnoty:
  • "interní" – interní komponenta, zařízení je součástí systému a připojuje se uvnitř počítače.
  • "externí" – externí komponenta, zařízení je externí zařízení (periferní zařízení), které se připojuje k počítači.
  • "internalExternal" – zařízení lze připojit interně (uvnitř počítače) i externě (periferní zařízení).
  • notSet – nejsou k dispozici žádná data
isTestSign logický Určuje, zda je produkt podepsaným testovacím ovladačem. Další informace o balíčcích ovladačů s testovacím podpisem naleznete v tématu WHQL Test Signature Program
isFlightSign logický Určuje, jestli je produkt řidičem podepsaným letem. Ovladače podepsané pro testovací účely jsou testovací ovladače, které lze publikovat prostřednictvím Windows Update. Dají se publikovat nebo nainstalovat jenom na počítačích zaregistrovaných do programu Windows Insider. Dají se nainstalovat na počítače bez zakázání zabezpečeného spouštění. Nejde je nainstalovat na maloobchodní počítače, které nejsou součástí programu Windows Insider.
marketingové názvy pole řetězců Marketingové názvy nebo aliasy produktu
název produktu Řetězec Název ovladače, jak je uvedeno při vytváření
vybrané typy produktů slovník Pár hodnot klíče, kde oba jsou řetězce.
požadované podpisy pole řetězců Seznam podpisů operačních systémů, pro které je produkt certifikován. Seznam všech operačních systémů najdete v seznamu kódů operačního systému.
dalšíAtributy Objekt Další informace naleznete v dalších atributech objektu.
testHarness řetězec Typ odeslaného balíčku. Možné hodnoty:
  • hlk
  • hck
  • ověření identity
  • nenastaveno
datum oznámení datetime Datum, kdy se produkt zahrne do katalogu Systému Windows Server.

Zdroj předložení

Tento zdroj představuje podání produktu.

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

Tento prostředek má následující hodnoty:

Hodnota Typ Popis
identifikátor dlouhý ID podání
Produktové ID dlouhý Privátní ID produktu, ke kterému je toto odeslání přidružené
stav pracovního postupu objekt Tato možnost je k dispozici pouze při načítání podrobností o konkrétním odeslání. Tento objekt znázorňuje stav pracovního postupu pro toto odeslání. Další informace naleznete v tématu stavový objekt pracovního postupu.
Odkazy pole objektů Další podrobnosti najdete v objektu odkazu.
stav potvrzení Další podrobnosti najdete v tématu Správa odesílaných produktů .
isExtensionInf logický Určuje, zda je podání ovladačem rozšíření.
jeUniverzální logický Určuje, jestli odeslání projde testem univerzálního rozhraní API. Ovladač je kompatibilní s DCHU, pokud je deklarativní a univerzální
isDeclarativeInf logický Určuje, zda odevzdání splňuje deklarativní test INVerif. Ovladač je kompatibilní s DCHU, pokud je deklarativní a univerzální.
Název řetězec Název příspěvku.
Typ řetězec Určuje, zda je odeslání počáteční nebo odvozené odeslání. Možné hodnoty:
  • počáteční
  • odvozený
stahování souborů objekt Tato možnost je k dispozici pouze při načítání podrobností o konkrétním odeslání. Tento objekt znázorňuje soubory ke stažení, které jsou k dispozici pro odeslání. Další informace najdete v tématu stažení objektu.

Objekt Stav pracovního postupu

Tento objekt představuje stav pracovního postupu pro danou entitu.

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

Tento objekt má následující hodnoty.

Hodnota Typ Popis
aktuální krok řetězec Název aktuálního kroku v celkovém pracovním postupu pro tuto entitu.
Pro příjem dat a odeslání balíčku jsou možné hodnoty (popis v závorkách):
  • packageInfoValidation (ověřování metadat a obsahu balíčku)
  • příprava (příprava balíčku ke zpracování)
  • skenování (skenování obsahu balíčku na malware)
  • ověření (ověření výsledků testu)
  • catalogCreation (Vytvoření katalogu zabezpečení pro balíček)
  • manualReview (Probíhá ruční revize)
  • podepisování (podepisování binárních souborů)
  • finalizeIngestion (Dokončení příjmu dat a příprava podepsaných souborů ke stažení nebo publikování)
Stát řetězec Stav aktuálního kroku. Možné hodnoty:
  • nezahájeno
  • začalo
  • selhalo
  • dokončené
Zprávy pole Pole řetězců pro poskytování zpráv o aktuálním kroku (zejména v případě selhání)

Stažení objektu

Tento objekt představuje stažené soubory pro určitou odeslanou verzi.

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

Tento objekt má následující hodnoty.

Hodnota Typ Popis
Položky pole Pole typů stahování a adresy URL pro každý z nich.
Typ řetězec Typ balíčku, který je k dispozici ke stažení. Možné hodnoty:
  • "initialPackage" – balíček nahraný uživatelem (pro nové odeslání odkazuje na identifikátor URI SAS pro nahrání balíčku).
  • "derivedPackage" – rozhraní pro odvozené příspěvky
  • "signedPackage" – balíček podepsaný Microsoftem
  • "certificationReport" – zpráva o certifikaci podepsaného produktu
  • driverMetadata – odkaz odkazuje na soubor, který umožňuje stáhnout metadata ovladače. Další informace najdete v tématu metadata balíčku ovladačů.
  • Externí poznámky
  • Neznámý
Zprávy pole Pole řetězců, které poskytují zprávy o souborech ke stažení

Tento objekt představuje seznam užitečných odkazů pro nadřazenou entitu.

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

Tento objekt má následující hodnoty.

Hodnota Typ Popis
Href Řetězec Adresa URL pro přístup k prostředku přes rozhraní API
Rel Řetězec Typ prostředku Možné hodnoty:
  • self – Odkaz vede zpět k sobě
  • next_link – odkaz ukazuje na další zdroj, který se obvykle používá pro stránkování
  • get_submissions – odkaz odkazuje na všechna odeslání produktu
  • commit_submission – odkaz odkazuje na potvrzení odeslání
  • update_submission – odkaz odkazuje na aktualizaci odeslání
  • update_shippinglabel – odkaz odkazuje na aktualizaci expedičního štítku
Metoda Řetězec Typ metody http, která se má použít při vyvolání adresy URL. Možné hodnoty:
  • ZÍSKAT
  • PŘÍSPĚVEK
  • ZÁPLATA

Další objekt atributu

Tento objekt poskytuje více atributů o produktu, pokud se jedná o typ řadiče RAID, řadiče úložiště nebo programu OVĚŘOVÁNÍ virtualizace serveru (SVVP). Může obsahovat jeden ze tří typů objektů – StorageController, RaidController nebo SVVP.

StorageController – objekt

Hodnota Typ Popis
verze BIOSu řetězec Verze ROM BIOSu
verze firmwaru řetězec Verze firmwaru
verze ovladače řetězec ** Verze ovladače
jméno řidiče řetězec Název ovladače
verze zařízení řetězec Verze zařízení
Název čipové sady řetězec Název čipové sady
použitý proprietární Boolean Více cest podporované prostřednictvím proprietárního ovladače. Pokud je to pravda, pak jsou ProprietaryName a ProprietaryVersion povinné.
proprietární název řetězec Název softwaru s více cestami
proprietární verze řetězec Verze softwaru s více cestami
použitý Microsoft Boolean Microsoft MPIO podporovaný prostřednictvím modulu specifického pro zařízení. Pokud je true, pak microsoftName a microsoftVersion jsou povinné.
microsoftName řetězec Název softwaru s více cestami
microsoftVersion řetězec Verze softwaru s více cestami
usedBootSupport Boolean Podpora spouštění
usedBetterBoot Boolean Podpora spouštění > 2,2 TB Pokud je pravda, je povinná podporovaná verze rozhraní UEFI a podporovaná verze ACPI.
uefiVersion řetězec Podporovaná verze rozhraní UEFI
acpiVersion řetězec Podporovaná verze ACPI
Podporuje sektor 4K512E Boolean Velikost sektoru podpory 4K/512e
supportsSector4K4KK Boolean Velikost sektoru podpory 4K/4K
podporuje diferenciální Boolean Diferenciální (vysokonapěťový diferenciál)

RaidController – objekt

Hodnota Typ Popis
verze firmwaru řetězec Verze firmwaru
verze filtru řetězec ** Verze ovladače
verze ovladače řetězec Verze filtru
použitý proprietární Boolean Více cest podporované prostřednictvím proprietárního ovladače. Pokud je true, pak proprietaryName a proprietaryVersion jsou povinné
proprietární název řetězec Název softwaru s více cestami
proprietární verze řetězec Verze softwaru s více cestami
použitý Microsoft Boolean Microsoft MPIO podporovaný prostřednictvím modulu specifického pro zařízení. Pokud je true, pak jsou microsoftName a microsoftVersion povinné.
microsoftName řetězec Název softwaru s více cestami
microsoftVersion řetězec Verze softwaru s více cestami
jePotřebnáTřetíStrana Boolean Ovladač jiných společností než Microsoft potřebný pro připojení
isSES Boolean SES (SCSI Enclosure Services, služby pro uzavření SCSI). Označuje, zda je SES součástí. Rozhraní SCSI je standardní termín pro sběrnici, která připojuje zařízení v systému, původně Small Computer System Interface. SLUŽBA SES je zkratka pro službu SCSI Enclosure Services.
isSAFTE Boolean SAF-TE (specifikace ANBll). Udává, zda je SAF-TE zahrnuta. ANBll oborová specifikace. SAF-TE je zkratka pro zařízení odolná proti chybám SCSI. Rozhraní SCSI je standardní termín pro sběrnici, která připojuje zařízení v systému, původně Small Computer System Interface.
doplňkové informace řetězec Další informace

SVVP – objekt

Hodnota Typ Popis
verze produktu řetězec Verze produktu
supportLink řetězec Adresa URL podpory
hostovaný OS řetězec Hostovaný operační systém. Možné hodnoty:
  • Systém Windows Server 2008
  • Windows Server 2008 Release 2
  • Windows Server 2012
  • Windows Server 2012 R2
architektura procesoru řetězec Architektura hardwarového procesoru. Možné hodnoty:
  • Xeon
  • Opteron
  • Itanium 2
maxProcessors integer Maximální počet procesorů na virtuálním počítači
maximální paměť integer Maximální velikost paměti ve virtuálním počítači (v GB)

Seznam typů produktů

Produkt může být z následujících typů. Spolu s operačním systémem se tyto informace používají k identifikaci použitelnosti.

  • 3D tiskárna
  • Senzor akcelerometru
  • Vše v jednom
  • Vše v jednom s dotykovým ovládáním
  • Zvukové zařízení
  • Objekty pro zpracování zvuku
  • Ovladač Bluetooth
  • Ovladač Bluetooth bez USB
  • Fotoaparát
  • Snímač fotoaparátu
  • klastr
  • Výpočetní akcelerátor MCDM 2.7
  • Výpočetní akcelerátor MCDM 3.1
  • Výpočetní akcelerátor MCDM 3.2
  • konvertibilní tablet
  • Stolní počítač
  • Renderer digitálních médií
  • Digital Media Server
  • Digitální fotoaparáty na statické snímky
  • Digitální videokamery
  • Zařízení s povolenou správou kontroly distribuce
  • Podniková tiskárna WSD s více funkcemi
  • Čtečka tisku prstem
  • Herní ovladač
  • Obecný kontroler
  • Obecné přenosné zařízení
  • Grafický adaptér MCDM2.7
  • Grafický adaptér MCDM2.8
  • Grafický adaptér MCDM2.9
  • Grafický adaptér MCDM3.0
  • Grafický adaptér WDDM1.0
  • Grafický adaptér WDDM1.1
  • Grafický adaptér WDDM1.2
  • Grafický adaptér WDDM1.2 DisplayOnly
  • Grafický adaptér WDDM1.2 RenderOnly
  • Grafický adaptér WDDM1.3
  • Grafický adaptér WDDM1.3 DisplayOnly
  • Grafický adaptér WDDM1.3 RenderOnly
  • Grafický adaptér WDDM2.0
  • Grafický adaptér s podporou displeje WDDM2.0
  • Grafický adaptér WDDM2.0 pouze pro renderování
  • Grafický adaptér WDDM2.1
  • Pouze grafický adaptér WDDM2.1
  • Adaptér grafiky WDDM2.1 pouze pro vykreslení
  • Grafický adaptér WDDM2.2
  • Grafický adaptér pouze pro zobrazení WDDM2.2
  • Adaptér grafické karty WDDM2.2 pouze pro vykreslování
  • Grafický adaptér WDDM2.3
  • Grafický adaptér WDDM2.3 – pouze displej
  • Pouze vykreslení grafického adaptéru WDDM2.3
  • Grafický adaptér WDDM2.4
  • Pouze grafický adaptér WDDM2.4
  • WDDM2.4 grafický adaptér pouze pro vykreslování
  • Grafický adaptér WDDM2.4 VM
  • Grafický adaptér WDDM2.5
  • Grafický adaptér pouze pro displej WDDM2.5
  • Grafický adaptér WDDM2.5 pouze pro vykreslování
  • Grafický adaptér WDDM2.5 VM
  • Grafický adaptér WDDM2.6
  • Grafický adaptér pouze pro zobrazení WDDM2.6
  • Pouze vykreslení grafického adaptéru WDDM2.6
  • Grafický adaptér WDDM2.6 VM
  • Grafický adaptér WDDM2.7
  • Grafický adaptér pouze pro zobrazení WDDM2.7
  • Pouze vykreslení grafického adaptéru WDDM2.7
  • Grafický adaptér WDDM2.7 VM
  • Grafický adaptér WDDM2.8
  • Grafický adaptér pro zobrazení pouze WDDM2.8
  • Pouze vykreslení grafického adaptéru WDDM2.8
  • Grafický adaptér WDDM2.8 VM
  • Grafický adaptér WDDM2.9
  • Grafický adaptér WDDM2.9 pouze pro zobrazení
  • Grafický adaptér WDDM2.9 pouze pro vykreslování
  • Grafický adaptér WDDM2.9 VM
  • Grafický adaptér WDDM3.0
  • Pouze grafický adaptér displeje WDDM3.0
  • Pouze vykreslení grafického adaptéru WDDM3.0
  • Grafický adaptér WDDM3.0
  • Grafický adaptér WDDM3.1
  • Grafický adaptér WDDM3.1 - pouze zobrazení
  • WDDM3.1 grafický adaptér pro vykreslování
  • Grafický adaptér WDDM3.1 VM
  • Grafický adaptér WDDM3.2
  • Grafický adaptér pouze pro zobrazení WDDM3.2
  • Grafický adaptér WDDM3.2 Jen pro vykreslování
  • Grafický adaptér WDDM3.2 VM
  • Grafický tablet
  • Senzor gyroskopu
  • Pevný disk
  • Multifunkční přeměny hardwaru
  • Klávesnice
  • Přepínač klávesnice, videa a myši
  • Síť LAN
  • LAN (server)
  • LAN CS
  • Virtuální počítač LAN (server)
  • Notebook
  • Přenosný počítač s dotykovým ovládáním
  • LCD
  • Světelný senzor
  • Senzor polohy
  • Media Player
  • Mobilní širokopásmové CDMA
  • Mobilní širokopásmové GSM
  • Mobilní telefon
  • Obrazovka
  • Základní deska
  • Fúze snímače pohybu
  • Tiskárna s více funkcemi
  • Blízké Pole Proximitní
  • Síťové médium
  • NFC
  • Čtečka čipových karet NFC
  • Optická jednotka
  • Pen Digitizer
  • Ukazování v kresbě
  • PrecisionTouchpad
  • Senzor přítomnosti
  • Tiskárna
  • Projektor
  • Vyměnitelné úložiště
  • Směrovač
  • Skener
  • Kontroler SDIO
  • počítačový server
  • Ověřovací program virtualizace serveru
  • Tablet s podpisy
  • Čipové karty
  • Čtečka čipových karet
  • Systém úložiště
  • Řadič úložiště
  • Adaptér úložiště
  • Jednotka Prostorů úložiště
  • Tableta
  • Dotykové ovládání
  • Dotykový monitor
  • TPM20
  • Ultramobilní PC
  • Ultra-Mobile PC s dotykovým ovládáním
  • Řadič USB
  • Rozbočovač USB
  • WebCam
  • WLAN
  • WLAN CSB
  • Tiskárna s více funkcemi WSD
  • Tiskárna WSD
  • Skener WSD

Seznam kódů rodiny operačních systémů

Následující tabulka uvádí kódy rodiny operačních systémů a jejich popisy.

Kód rodiny operačního systému Popis
WindowsMe Windows Me
Windows2000 Systém Windows 2000
Windows98 Systém Windows 98
WindowsNT40 Windows NT 4.0
WindowsXP Windows XP
WindowsServer2003 Systém Windows Server 2003
WindowsVista Windows Vista
Windows2008Server Systém Windows Server 2008
WindowsHomeServer Windows Home Server
Windows7 Windows 7
Windows2008ServerR2 Windows Server 2008 Release 2
WindowsServerSolutions Řešení pro Windows Server
Windows8 Windows 8
Windows8Server Windows Server 2012
Windows81 Windows 8.1
Windows81Server Windows Server 2012 R2
Windows_v100 Prahová hodnota Windows 10
Windows_v100Server Prahová hodnota Windows Serveru
Windows_v100_RS1 Windows 10 výroční aktualizace
Windows_v100Server_RS1 Windows Server 2016
Windows_v100_RS2 Windows 10 RS2 Update
Windows_v100Server_RS2 Windows Server RS2
Windows_v100_RS3 Windows 10 RS3 Aktualizace
Windows_v100Server_RS3 Windows Server RS3
Windows_v100_RS4 Windows 10 RS4 Update
Windows_v100Server_RS5 Windows Server 2019
Windows_v100_RS5 Windows 10 RS5 x86
Windows_v100_RS5 Windows 10 RS5 x64
Windows_v100_19H1 Aktualizace Windows 10 19H1
Windows_v100_VB Windows 10 verze 2004
Windows_v100Server_FE Windows – Server verze 21H2
Windows_v100_CO Windows – klient verze 21H2
Windows_v100_NI Klient Windows 11 verze 22H2
Windows_v100_GE Klient Windows 11 verze 24H2
Windows_v100Server_GE Windows Server 2025
Windows_v100_25H2 Klient Windows 11 verze 25H2
Windows_v100_26H1 Klient Windows 11 verze 26H1

Seznam kódů operačního systému

Následující tabulka uvádí kódy operačního systému a jejich popisy.

Kód operačního systému Popis
WINDOWS_ME Windows Me
WINDOWS_98 Systém Windows 98
WINDOWS_2000 Systém 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 Systém Windows Server 2003
WINDOWS_2003_IA64 Windows Server 2003 IA64
WINDOWS_2003_X64 Windows Server 2003 X64
WINDOWS_VISTA Klient systému Windows Vista
WINDOWS_VISTA_X64 Klient Windows Vista X64
WINDOWS_2008_SERVER Systém Windows Server 2008
WINDOWS_2008_SERVER_IA64 Windows Server 2008 IA64
WINDOWS_2008_SERVER_X64 Windows Server 2008 X64
Domácí server Windows Windows Home Server
WINDOWS_7 Klient windows 7
WINDOWS_7_X64 Klient windows 7 x64
WINDOWS_2008_SERVER_R2_IA64 Windows Server 2008 Release 2 IA64
WINDOWS_2008_SERVER_R2_X64 Windows Server 2008 Release 2 x64
WINDOWS_SERVER_SOLUTIONS_X64 Windows Server Solutions x64
Windows 8 Klient Windows 8
WINDOWS_8_X64 Klient windows 8 x64
WINDOWS_8_ARM Windows 8 Client RT
WINDOWS_8_SERVER_X64 Windows Server 2012
WINDOWS_v63 Klient Windows 8.1
WINDOWS_v63_X64 Klient Windows 8.1 x64
WINDOWS_v63_ARM Windows 8.1 Client RT
WINDOWS_v63_SERVER_X64 Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL Windows 10 Client verze 1506 a 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL Windows 10 Client verze 1506 a 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL Windows 10 Client verze 1506 a 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL Windows 10 Client verze 1506 a 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL Klient Windows 10 verze 1607
WINDOWS_v100_X64_RS1_FULL Klient Windows 10 verze 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL Windows Server 2016 x64 (RS1)
WINDOWS_v100_RS2_FULL Klient Windows 10 RS2
WINDOWS_v100_X64_RS2_FULL Klient Windows 10 RS2 x64
WINDOWS_v100_RS3_FULL Klient Windows 10 RS3
WINDOWS_v100_X64_RS3_FULL Klient Windows 10 RS3 x64
WINDOWS_v100_ARM64_RS3_FULL Windows 10 RS3 Client Arm64
WINDOWS_v100_RS4_FULL Klient Windows 10 RS4
WINDOWS_v100_X64_RS4_FULL Windows 10 RS4 Client x64
WINDOWS_v100_ARM64_RS4_FULL Windows 10 RS4 Client 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 Client x64
WINDOWS_v100_19H1_FULL Klient Windows 19H1 x86
WINDOWS_v100_X64_19H1_FULL Klient Windows 19H1 x64
WINDOWS_v100_ARM64_19H1_FULL Windows 19H1 Client Arm64
WINDOWS_v100_VB_FULL Windows 10 verze 2004 Client x86
WINDOWS_v100_X64_VB_FULL Windows verze 2004 Client x64
WINDOWS_v100_ARM64_VB_FULL Windows verze 2004 Arm64 Klient
WINDOWS_v100_SERVER_X64_FE_FULL Windows – Server verze 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL Windows – Server verze 21H2 Arm64
WINDOWS_v100_X64_CO_FULL Windows – klient verze 21H2 x64
WINDOWS_v100_ARM64_CO_FULL Windows – klient verze 21H2 Arm64
WINDOWS_v100_X64_NI_FULL Klient Windows 11 verze 22H2 x64
WINDOWS_v100_ARM64_NI_FULL Klient Windows 11 verze 22H2 Arm64
WINDOWS_v100_X64_GE_FULL Klient Windows 11 verze 24H2 x64
WINDOWS_v100_ARM64_GE_FULL Klient Windows 11 verze 24H2 ARM64
WINDOWS_v100_SERVER_X64_GE_FULL Windows Server 2025 x64
WINDOWS_v100_SERVER_ARM64_GE_FULL Windows Server 2025 ARM64
WINDOWS_v100_X64_25H2_FULL Klient Windows 11 verze 25H2 x64
WINDOWS_v100_ARM64_25H2_FULL Klient Windows 11 verze 25H2 ARM64
WINDOWS_v100_ARM64_26H1_FULL Klient Windows 11 verze 26H1 ARM64

Kódy chyb

Kódy chyb platí pro všechny webové metody rozhraní API. Pokud požadavek nejde úspěšně dokončit, odpověď obsahuje jeden z následujících kódů chyb HTTP.

Stav HTTP Popis
400 – Chybný požadavek Požadavek není správně formátovaný (například špatně formátovaná syntaxe požadavku, neplatné rámování zpráv požadavku nebo deceptivní směrování požadavků)
401 – Neautorizováno Ověření selhalo nebo nebylo zadáno.
403 – Zakázáno Zakázáno přistupovat k prostředku.
404 – Nenalezena Požadovaná entita se nenašla.
415 – Nepodporovaný typ média Náklad je ve formátu, který tato metoda na cílovém prostředku nepodporuje.
422 – nezpracovaná entita Selhání ověřování.
429 – Příliš mnoho požadavků Odesílá se příliš mnoho požadavků. Volání jsou omezena a čas prodlevy je uveden v odpovědi.
500 – Vnitřní chyba serveru Na serveru rozhraní API došlo k neopravitelné chybě.

Pokud dojde k selháním ověření funkčnosti, text odpovědi obsahuje jeden z následujících kódů chyb funkčnosti.

Kód chyby Zpráva o chybě Popis
Neplatný vstup Vráceno, když selže ověření vstupu.
Požadavek neplatný pro současný stav Pouze podání ve stavu čekání mohou být potvrzena. Vrátí se, když je potvrzení aplikováno na podání, které není ve stavu čekání.
Požadavek neplatný pro současný stav Počáteční odeslání již existuje. Vráceno při vytvoření počátečního odeslání pro ovladač, který již má počáteční odeslání.
Požadavek neplatný pro současný stav Nelze vytvořit odvozené odeslání, protože se nevytvořilo žádné počáteční odeslání. Vráceno při vytvoření odvozeného předložení pro ovladač, který nemá počáteční předložení.
Aktualizace nepovolena Nemá oprávnění k aktualizaci produktu Vráceno při pokusu o aktualizaci sdíleného produktu (přeprodání), protože sdílené produkty nelze aktualizovat.
Aktualizace nepovolena Nejde aktualizovat produkt bez počátečního odeslání Vráceno při pokusu o aktualizaci produktu, který nemá počáteční odeslání.
Aktualizace nepovolena Produkt nejde aktualizovat, protože pracovní postup selhal Vráceno při pokusu o aktualizaci produktu, který má neúspěšný pracovní postup.
Aktualizace nepovolena Datum oznámení se po dokončení procesu příjmu dat nedají aktualizovat. Vrátí se, když je datum oznámení aktualizováno po dokončení příjmu dat.
Aktualizace nepovolena Název produktu nelze v tuto chvíli aktualizovat. Zkuste to ještě jednou.
Aktualizace nepovolena Nemá oprávnění k aktualizaci podání Vráceno při pokusu o aktualizaci zaslaného produktu, který byl sdílen, protože sdílené produkty nelze aktualizovat.
Aktualizace nepovolena Odeslání nelze aktualizovat, protože pracovní postupy selhaly. Vráceno při pokusu o aktualizaci odeslání, které má neúspěšný pracovní postup.
EntitaNenalezena Nenašlo se žádné odeslání. Vráceno při pokusu o potvrzení zadání, které neexistuje.
EntitaNenalezena Produkt nebyl nalezen. Při pokusu o vytvoření předložení, pro které neexistuje produkt, je vrácena tato zpráva.
Neplatný vstup Ovladače rozšíření musí být publikovány jako automatická aktualizace. Hodnota isAutoInstallDuringOSUpgrade nebo isAutoInstallOnApplicableSystems musí být true. Vráceno při vytvoření expedičního štítku aktualizace Windows pro INF rozšíření bez výběru isAutoInstallDuringOSUpgrade nebo isAutoInstallOnApplicableSystems.
Neplatný vstup Identifikátory CHID jsou povoleny pouze v případě, že jsou identifikátory HardwareId určené pro operační systémy Windows 10 a novější. Vrátí se, když se vytvoří expediční štítek, který je určen pro operační systém starší než Windows 10 a cílí na CHID. Cílení na CHID platí jenom pro Windows 10 a novější verze.
Neplatný vstup Nelze aktualizovat expediční štítek, pokud probíhá jiný pracovní postup. Zkuste to ještě jednou. Vrátí se, když se expediční štítek aktualizuje, zatímco předchozí pracovní postup je stále v průběhu.
Požadavek neplatný pro současný stav Nelze vytvořit expediční štítek publikování pro doručenou poštu nebo typ systému. Jeden může sdílet pouze expediční štítek. Vráceno při vytvoření expedičního štítku windows update na ovladači doručené pošty nebo systému.
Požadavek neplatný pro současný stav Odeslání ještě není připravené k vytvoření expedičního štítku. Zkuste to za chvíli znovu. Je vráceno, když je přepravní štítek vytvořen bez čekání na dokončení přípravy nebo předběžného zpracování.

Viz také