Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usare i metodi seguenti nelle API hardware Microsoft per recuperare i dati per i prodotti hardware registrati nell'account Dev Center. Per un'introduzione alle API hardware Microsoft, inclusi i prerequisiti per l'uso dell'API, vedere Gestire gli invii di hardware usando le API.
https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/
Prima di poter usare questi metodi, il prodotto deve esistere già nel tuo account Dev Center. Per creare o gestire gli invii per i prodotti, vedi i metodi in Gestire gli invii di prodotti.
| Metodo | URI (Identificatore Uniforme delle Risorse) | Descrizione |
|---|---|---|
| OTTIENI | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ |
Ottenere i dati per tutti i prodotti |
| OTTIENI | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} |
Ottenere dati per un prodotto specifico |
| OTTIENI | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions |
Ottenere i dati per tutti gli invii di un prodotto |
| OTTIENI | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} |
Ottenere dati per un invio specifico di un prodotto |
Prerequisiti
Completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi.
Risorse dati
I metodi delle API hardware Microsoft per ottenere i dati del prodotto usano le risorse dati JSON seguenti
La risorsa del prodotto
Questa risorsa rappresenta un prodotto hardware (driver) registrato nell'account.
{
"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",
}
Questa risorsa ha i valori seguenti
| Valore | Tipo | Descrizione |
|---|---|---|
| id | Lungo | ID privato del prodotto |
| sharedProductId | Lungo | ID prodotto condiviso del prodotto |
| Collegamenti | matrice di oggetti | Per altri dettagli, consultare l'oggetto collegamento |
| èImpegnato | Booleano | Indica se il prodotto ha almeno una submission confermata |
| isExtensionInf | Booleano | (DEPRECATO) Indica se il prodotto è un driver di estensione. Questo campo è deprecato e non deve più essere usato. isExtensionInf spostato in una proprietà del livello di invio. |
| deviceMetadataIds | matrice di GUID | GUID che eseguono il mapping degli invii di metadati del dispositivo al driver |
| Tipo di dispositivo | Stringa | Indica il tipo di dispositivo. I valori possibili sono:
|
| èSegnoDiTest | Booleano | Indica se il prodotto è un driver firmato di test. Per ulteriori informazioni sui pacchetti driver con firma di test, vedere WHQL Test Signature Program |
| èSegnaleDiVolo | Booleano | Indica se il prodotto è un driver firmato per la fase di test. I driver firmati per il volo sono driver testati che possono essere pubblicati tramite Windows Update. Possono essere pubblicati/installati solo nei computer iscritti al Programma Windows Insider. Possono essere installati nei computer senza disabilitare l'avvio protetto. Non possono essere installati nei computer di vendita al dettaglio che non fanno parte del Programma Windows Insider. |
| marketingNames | matrice di stringhe | Nomi di marketing o alias del prodotto |
| nome del prodotto | Stringa | Nome del driver come specificato durante la creazione |
| tipi di prodotto selezionati | dizionario | Coppia chiave-valore in cui entrambe sono stringhe.
|
| firmeRichieste | matrice di stringhe | Elenco delle firme del sistema operativo per cui è certificato il prodotto. Per un elenco di tutti i sistemi operativi, vedere l'elenco dei codici del sistema operativo. |
| attributi aggiuntivi | Oggetto | Per ulteriori informazioni, vedere additional attributes object. |
| testHarness | corda | Tipo di pacchetto inviato. I valori possibili sono:
|
| data di annuncio | data e ora | Data in cui il prodotto viene incluso nel catalogo di Windows Server. |
Risorsa di invio
Questa risorsa rappresenta un invio di un prodotto.
{
"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"
}
Questa risorsa ha i valori seguenti:
| Valore | Tipo | Descrizione |
|---|---|---|
| id | lungo | ID dell'invio |
| ID del prodotto | lungo | ID prodotto privato a cui è associato l'invio |
| workflowstatus | oggetto | Questa opzione è disponibile solo quando si recuperano i dettagli di un invio specifico. Questo oggetto illustra lo stato del flusso di lavoro per questo invio. Per altre informazioni, vedere oggetto stato del flusso di lavoro. |
| Collegamenti | matrice di oggetti | Per ulteriori dettagli, fare riferimento al link object |
| stato di commit | Per altri dettagli, vedi Gestire gli invii di prodotti. | |
| isExtensionInf | Booleano | Indica se la presentazione è un driver di estensione |
| isUniversal | Booleano | Indica se l'invio supera il test dell'API universale. Un driver è conforme a DCHU se è dichiarativo e universale |
| isDeclarativeInf | Booleano | Indica se l'invio supera il test INVerif dichiarativo. Un driver è conforme a DCHU se è Dichiarativo e Universale. |
| Nome | corda | Nome dell'invio. |
| Tipo | corda | Indica se l'invio è un invio iniziale o derivato. I valori possibili sono:
|
| scaricamenti | oggetto | Questa opzione è disponibile solo quando si recuperano i dettagli di un invio specifico. Questo oggetto illustra i download disponibili per l'invio. Per ulteriori informazioni, vedere oggetto download. |
Oggetto Stato del flusso di lavoro
Questo oggetto rappresenta lo stato del flusso di lavoro per una determinata entità
{
"currentStep": "finalizeIngestion",
"state": "completed",
"messages": []
}
Questo oggetto ha i valori seguenti
| Valore | Tipo | Descrizione |
|---|---|---|
| passo corrente | corda | Nome del passaggio corrente nel flusso di lavoro complessivo per questa entità. Per l'acquisizione/l'invio di pacchetti, i valori possibili sono (descrizione tra parentesi):
|
| Stato | corda | Stato del passaggio corrente. I valori possibili sono:
|
| Messaggi | elenco | Matrice di stringhe per fornire messaggi relativi al passaggio corrente (soprattutto in caso di errore) |
Scaricare l'oggetto
Questo oggetto rappresenta i download per un determinato invio.
{
"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"
},
{
"type": "unreferencedFilesReport",
"url": "<SAS URL from Hardware API>"
}
],
"messages": []
}
Questo oggetto ha i valori seguenti
| Valore | Tipo | Descrizione |
|---|---|---|
| Elementi | elenco | Matrice di tipi di download e URL per ognuno di essi. |
| Tipo | corda | Tipo di pacchetto disponibile per il download. I valori possibili sono:
|
| Messaggi | elenco | Matrice di stringhe per fornire messaggi sui file scaricabili |
Oggetto di collegamento
Questo oggetto rappresenta un elenco di collegamenti utili per l'entità contenitore
{
"href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
}
Questo oggetto ha i valori seguenti
| Valore | Tipo | Descrizione |
|---|---|---|
| Href | Stringa | URL per accedere alla risorsa tramite l'API |
| Rel | Stringa | Tipo di risorsa. I valori possibili sono:
|
| Metodo | Stringa | Tipo del metodo http da usare quando si richiama l'URL. I valori possibili sono:
|
Oggetto Attribute aggiuntivo
Questo oggetto fornisce altri attributi sul prodotto se è di tipo controller RAID, controller di archiviazione o programma SVVP (Server Virtualization Validation Program). Può contenere uno dei tre tipi di oggetti StorageController, RaidController o SVVP.
Oggetto StorageController
| Valore | Tipo | Descrizione |
|---|---|---|
| versione BIOS | corda | VERSIONE BIOS ROM |
| versione del firmware | corda | Versione del firmware |
| versione del driver | corda | Versione driver |
| nomeConducente | corda | Nome del driver |
| versioneDispositivo | corda | Versione del dispositivo |
| nome del chipset | corda | Nome chipset |
| usatoProprietario | booleano | Il supporto per il multi-percorso è fornito tramite un driver proprietario. Se vero, allora proprietaryName e proprietaryVersion sono obbligatori. |
| nome proprietario | corda | Nome software multicanale |
| versione proprietaria | corda | Versione del software multi-canale |
| usedMicrosoft | booleano | Microsoft MPIO supportato attraverso un modulo specifico per dispositivi. Se true, microsoftName e microsoftVersion sono obbligatori. |
| microsoftName | corda | Nome software multi-percorso |
| microsoftVersion | corda | Versione del software multipercorso |
| usedBootSupport | booleano | Supporto per il boot |
| usedBetterBoot | booleano | Supporto di avvio > da 2,2 TB. Se true, la versione UEFI supportata e la versione ACPI supportata sono obbligatorie |
| uefiVersion | corda | Versione UEFI supportata |
| acpiVersion | corda | Versione ACPI supportata |
| supportsSector4K512E | booleano | Dimensione del settore di supporto per 4K/512e |
| supportsSector4K4K | booleano | Dimensioni del settore di supporto pari a 4K/4K |
| supportaDifferenziale | booleano | Differenziale (differenziale ad alta tensione) |
Oggetto RaidController
| Valore | Tipo | Descrizione |
|---|---|---|
| versione del firmware | corda | Versione del firmware |
| versioneFiltro | corda | Versione driver |
| versione del driver | corda | Versione del filtro |
| usatoProprietario | booleano | Supporto alla funzionalità multi-path mediante driver proprietario. Se vero, allora proprietarioName e proprietarioVersion sono obbligatori |
| nome proprietario | corda | Nome software multicanale |
| proprietariaVersion | corda | Versione del software a percorsi multipli |
| usedMicrosoft | booleano | Microsoft MPIO supportato tramite un modulo specifico progettato per dispositivi. Se true, microsoftName e microsoftVersion sono obbligatori |
| microsoftName | corda | Nome del software multi-traccia |
| microsoftVersion | corda | Versione del software multipercorsi |
| isTerzaParteNecessaria | booleano | Driver non Microsoft necessario per la connettività |
| isSES | booleano | SES (SCSI Enclosure Services) Indica se è incluso un SES. SCSI è il termine standard per un bus di servizio che connette i dispositivi in un sistema, originariamente Small Computer System Interface. SES è l'abbreviazione di SCSI Enclosure Services. |
| isSAFTE | booleano | SAF-TE (specifica ANBII). Indica se è incluso un SAF-TE. ANBll è una specifica del settore. SAF-TE è l'abbreviazione di enclosure a tolleranza di errore accessibile tramite SCSI. SCSI è il termine standard per un bus di servizio che connette i dispositivi in un sistema, originariamente Small Computer System Interface. |
| informazioni aggiuntive | corda | Informazioni aggiuntive |
Oggetto SVVP
| Valore | Tipo | Descrizione |
|---|---|---|
| versione del prodotto | corda | Versione del prodotto |
| supportLink | corda | URL del supporto |
| guestOs | corda | Sistema operativo guest. I valori possibili sono:
|
| architettura del processore | corda | Architettura del processore hardware. I valori possibili sono:
|
| maxProcessor | numero intero | Numero massimo di processori nella macchina virtuale |
| maxMemory | numero intero | Memoria massima nella macchina virtuale (in GB) |
Elenco dei tipi di prodotto
Un prodotto può essere dei tipi seguenti. Insieme al sistema operativo, queste informazioni vengono usate per identificare l'applicabilità.
- Stampante 3D
- Sensore Accelerometro
- Tutto in uno
- Tutto in uno con tocco
- Dispositivo audio
- Oggetti di elaborazione audio
- Bluetooth Controller
- Bluetooth Controller Non USB
- Fotocamera
- Sensore fotocamera
- Gruppo
- Acceleratore di calcolo MCDM 2.7
- Acceleratore di calcolo MCDM 3.1
- Acceleratore di calcolo MCDM 3.2
- Tablet convertibile
- Schermo
- Renderer multimediale digitale
- Digital Media Server
- Fotocamere digitali per foto fisse
- Fotocamere digitali
- Dispositivi abilitati per la gestione dell'analisi di distribuzione
- Stampante Multi-Funzione Enterprise WSD
- Lettore di stampa con dita
- Controller di gioco
- Controller generico
- Dispositivo portatile generico
- Scheda grafica MCDM2.7
- Scheda grafica MCDM2.8
- Scheda grafica MCDM2.9
- Scheda grafica MCDM3.0
- Adattatore grafico WDDM1.0
- Adattatore grafico WDDM1.1
- Adattatore Grafico WDDM1.2
- Scheda grafica WDDM1.2 DisplayOnly
- Adattatore grafico WDDM1.2 RenderOnly
- Scheda grafica WDDM1.3
- Adattatore grafico WDDM1.3 DisplayOnly
- Scheda grafica WDDM1.3 RenderOnly
- Adattatore grafico WDDM2.0
- Scheda grafica WDDM2.0 Solo schermo
- Adattatore grafico WDDM2.0 Solo renderizzazione
- Scheda grafica WDDM2.1
- Scheda grafica WDDM2.1 Solo schermo
- Adattatore grafico WDDM2.1 Solo render
- Adattatore grafico WDDM2.2
- Scheda grafica WDDM2.2 Solo schermo
- Scheda Grafica Renderizzazione Esclusiva WDDM2.2
- Adattatore grafico WDDM2.3
- Scheda grafica WDDM2.3 Solo schermo
- Solo Rendering WDDM2.3 dell'Adattatore Grafico
- Scheda grafica WDDM2.4
- Adattatore Grafico WDDM2.4 Display Solo
- Adattatore grafico WDDM2.4 Solo per rendering
- Adattatore Grafico WDDM2.4 VM
- Adattatore grafico WDDM2.5
- Scheda grafica WDDM2.5 Solo schermo
- Adattatore grafico WDDM2.5 solo rendering
- Adattatore grafico WDDM2.5 VM
- Scheda grafica WDDM2.6
- Scheda grafica WDDM2.6 Solo schermo
- Solo rendering dell'adattatore grafico WDDM2.6
- Scheda grafica WDDM2.6 VM
- Adattatore grafico WDDM2.7
- Solo schermo WDDM2.7 della scheda grafica
- Scheda Grafica WDDM2.7 Solo Rendering
- Scheda grafica WDDM2.7 VM
- Adattatore grafico WDDM2.8
- Scheda grafica WDDM2.8 Solo schermo
- Adattatore grafico WDDM2.8 Solo rendering
- Adattatore grafico WDDM2.8 VM
- Adattatore grafico WDDM2.9
- Scheda grafica WDDM2.9 Solo schermo
- Adattatore grafico WDDM2.9 Solo per Rendering
- Scheda grafica WDDM2.9 VM
- Scheda grafica WDDM3.0
- Scheda grafica WDDM3.0 Solo schermo
- Adattatore grafica WDDM3.0 Solo rendering
- Scheda grafica WDDM3.0 VM
- Scheda grafica WDDM3.1
- Adattatore grafico WDDM3.1 Solo per display
- Adattatore grafico WDDM3.1 solo per il rendering
- Adattatore grafico WDDM3.1 VM
- Scheda grafica WDDM3.2
- Scheda grafica WDDM3.2 Solo schermo
- Adattatore grafico WDDM3.2 Solo rendering
- Scheda grafica WDDM3.2 VM
- Tablet grafico
- Sensore giroscopio
- Disco rigido
- Trasformazioni multifunzione hardware
- Tastiera
- Interruttore del mouse video da tastiera
- LAN (rete locale)
- LAN (server)
- LAN CS
- Macchina virtuale LAN (server)
- Computer portatile
- Portatile con tocco
- LCD (Display a Cristalli Liquidi)
- Sensore chiaro
- Sensore di posizione
- Lettore multimediale
- Banda larga mobile CDMA
- Banda larga mobile GSM
- Cellulare
- Monitoraggio
- Scheda madre
- Fusione del sensore di movimento
- Stampante a più funzioni
- Prossimità di Campo Vicino
- Dispositivo multimediale di rete
- NFC
- Lettore NFC di smart card
- Unità ottica
- Digitalizzatore di penna
- Disegno di puntamento
- PrecisionTouchpad
- Sensore presenza
- Stampante
- Proiettore
- Archivi rimovibili
- Router
- Scansionatore
- SDIO Controller
- Servidor
- Programma di convalida della virtualizzazione server
- Tablet firma
- Smart cards
- Lettore smart card
- Array di archiviazione
- Controller di archiviazione
- Adattatore Spazi di archiviazione
- Unità Spazi di Archiviazione
- Tavoletta
- Toccare
- Touch Monitor
- TPM20
- PC Ultra-Mobili
- Ultra-Mobile PC con Touchscreen
- Controller USB
- USB Hub
- WebCam
- WLAN
- WLAN CSB
- Stampante a più funzioni WSD
- Stampante WSD
- WSD Scanner
Elenco dei codici della famiglia di sistemi operativi
Nella tabella seguente sono elencati i codici famiglia del sistema operativo e le relative descrizioni.
| Codice della famiglia di sistemi operativi | Descrizione |
|---|---|
| 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 | Server Windows per Uso Domestico |
| Windows7 | Windows 7 |
| Windows2008ServerR2 | Windows Server 2008 Versione 2 |
| WindowsServerSolutions | Soluzioni Windows Server |
| Windows8 | Windows 8 |
| Windows8Server | Windows Server 2012 |
| Windows81 | Windows 8.1 |
| Windows81Server | Windows Server 2012 R2 |
| Windows_v100 | Soglia di Windows 10 |
| Windows_v100Server | Soglia di Windows Server |
| Windows_v100_RS1 | Aggiornamento dell'anniversario di Windows 10 |
| 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 Update |
| Windows_v100Server_RS3 | Windows Server RS3 |
| Windows_v100_RS4 | Aggiornamento di 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 | Aggiornamento di Windows 10 19H1 |
| Windows_v100_VB | Windows 10 versione 2004 |
| Windows_v100Server_FE | Windows - Server, versione 21H2 |
| Windows_v100_CO | Windows - Client, versione 21H2 |
| Windows_v100_NI | Client Windows 11, versione 22H2 |
| Windows_v100_GE | Client Windows 11, versione 24H2 |
| Windows_v100Server_GE | Windows Server 2025 |
| Windows_v100_25H2 | Client Windows 11, versione 25H2 |
| Windows_v100_26H1 | Client Windows 11, versione 26H1 |
Elenco dei codici del sistema operativo
Nella tabella seguente sono elencati i codici del sistema operativo e le relative descrizioni.
| Codice del sistema operativo | Descrizione |
|---|---|
| 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 | Client di Windows Vista |
| WINDOWS_VISTA_X64 | Windows Vista Client 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 | Server Windows per Uso Domestico |
| WINDOWS_7 | Windows 7 Cliente |
| WINDOWS_7_X64 | Windows 7 Client 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 | Soluzioni Windows Server x64 |
| WINDOWS_8 | Windows 8 Client |
| WINDOWS_8_X64 | Windows 8 Client x64 |
| WINDOWS_8_ARM | Windows 8 Client RT |
| WINDOWS_8_SERVER_X64 | Windows Server 2012 |
| WINDOWS_v63 | Windows 8.1 Cliente |
| WINDOWS_v63_X64 | Windows 8.1 Client 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 versioni 1506 e 1511 (TH1) |
| WINDOWS_v100_X64_TH1_FULL | Windows 10 Client versioni 1506 e 1511 x64 (TH1) |
| WINDOWS_v100_SERVER_X64_TH1_FULL | Windows Server 2016 x64 (TH1) |
| WINDOWS_v100_TH2_FULL | Windows 10 Client versioni 1506 e 1511 (TH2) |
| WINDOWS_v100_X64_TH2_FULL | Windows 10 Client versioni 1506 e 1511 x64 (TH2) |
| WINDOWS_v100_SERVER_X64_TH2_FULL | Windows Server 2016 x64 (TH2) |
| WINDOWS_v100_RS1_FULL | Windows 10 Client versione 1607 |
| WINDOWS_v100_X64_RS1_FULL | Windows 10 Client versione 1607 x64 |
| WINDOWS_v100_SERVER_X64_RS1_FULL | Windows Server 2016 x64 (RS1) |
| WINDOWS_v100_RS2_FULL | Windows 10 RS2 Client |
| WINDOWS_v100_X64_RS2_FULL | Windows 10 RS2 Client x64 |
| WINDOWS_v100_RS3_FULL | Windows 10 RS3 Client |
| WINDOWS_v100_X64_RS3_FULL | Client Windows 10 RS3 x64 |
| WINDOWS_v100_ARM64_RS3_FULL | Windows 10 RS3 Client Arm64 |
| WINDOWS_v100_RS4_FULL | Windows 10 RS4 Client |
| 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 | Client Windows 10 RS5 x64 |
| WINDOWS_v100_19H1_FULL | Client Windows 19H1 x86 |
| WINDOWS_v100_X64_19H1_FULL | Client Windows 19H1 x64 |
| WINDOWS_v100_ARM64_19H1_FULL | Cliente Windows 19H1 Arm64 |
| WINDOWS_v100_VB_FULL | Windows 10 versione 2004 Client x86 |
| WINDOWS_v100_X64_VB_FULL | Windows versione 2004 Client x64 |
| WINDOWS_v100_ARM64_VB_FULL | Windows versione 2004 Client Arm64 |
| WINDOWS_v100_SERVER_X64_FE_FULL | Windows - Server, versione 21H2 x64 |
| WINDOWS_v100_SERVER_ARM64_FE_FULL | Windows - Server, versione 21H2 Arm64 |
| WINDOWS_v100_X64_CO_FULL | Windows - Client, versione 21H2 x64 |
| WINDOWS_v100_ARM64_CO_FULL | Windows - Client, versione 21H2 Arm64 |
| WINDOWS_v100_X64_NI_FULL | Client Windows 11, versione 22H2 x64 |
| WINDOWS_v100_ARM64_NI_FULL | Client Windows 11, versione 22H2 Arm64 |
| WINDOWS_v100_X64_GE_FULL | Client Windows 11, versione 24H2 x64 |
| WINDOWS_v100_ARM64_GE_FULL | Client Windows 11, versione 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 | Client Windows 11, versione 25H2 x64 |
| WINDOWS_v100_ARM64_25H2_FULL | Client Windows 11, versione 25H2 ARM64 |
| WINDOWS_v100_ARM64_26H1_FULL | Client Windows 11, versione 26H1 ARM64 |
Codici di errore
I codici di errore sono applicabili a tutti i metodi Web dell'API. Se la richiesta non può essere completata correttamente, la risposta contiene uno dei codici di errore HTTP seguenti.
| Stato HTTP | Descrizione |
|---|---|
| 400 - Richiesta non valida | Richiesta non corretta (ad esempio, sintassi delle richieste non valide, frame di messaggi di richiesta non validi o routing di richieste ingannevoli) |
| 401 - Non autorizzato | Autenticazione non riuscita o non fornita |
| 403 - Accesso negato | Non è consentito accedere a una risorsa. |
| 404 - Non trovato | L'entità richiesta non viene trovata. |
| 415 - Tipo di supporto non supportato | Il payload è in un formato non supportato da questo metodo nella risorsa di destinazione. |
| 422 - Entità non elaborabile | Errori di convalida. |
| 429 - Troppe richieste | Vengono inviate troppe richieste. Le chiamate vengono limitate e il tempo di backoff viene fornito nella risposta. |
| 500 - Errore interno del server | Si è verificato un errore irreversibile nel server API. |
In caso di errori di convalida funzionale, il corpo della risposta contiene uno dei codici di errore funzionali seguenti.
| Codice di errore | Messaggio di errore | Descrizione |
|---|---|---|
| Input non valido | Restituito quando una convalida di input ha esito negativo. | |
| RichiestaNonValidaPerStatoAttuale | È possibile eseguire il commit solo degli invii in sospeso | Restituito quando un commit viene applicato a un invio che non è in sospeso. |
| RichiestaNonValidaPerStatoAttuale | L'invio iniziale esiste già | Restituito quando viene creata una presentazione iniziale per un driver che ha già una presentazione iniziale. |
| RichiestaNonValidaPerStatoAttuale | Non è possibile creare l'invio derivato perché non è stato creato alcun invio iniziale | Restituito quando viene creato un invio derivato per un driver che non ha un invio iniziale. |
| AggiornamentoNonAutorizzato | Non autorizzato ad aggiornare il prodotto | Viene restituito un errore quando si tenta di aggiornare un prodotto condiviso (rivenduto) poiché i prodotti condivisi non possono essere aggiornati. |
| AggiornamentoNonAutorizzato | Non è possibile aggiornare il prodotto senza un invio iniziale | Restituito quando si tenta di aggiornare un prodotto che non ha un invio iniziale. |
| AggiornamentoNonAutorizzato | Impossibile aggiornare il prodotto perché il flusso di lavoro non è riuscito | Restituito quando si tenta di aggiornare un prodotto con un flusso di lavoro non riuscito. |
| AggiornamentoNonAutorizzato | La data di annuncio non può essere modificata al termine del processo di importazione | Restituito quando la data dell'annuncio viene aggiornata dopo il completamento dell'inserimento. |
| AggiornamentoNonAutorizzato | Al momento non è possibile aggiornare il nome del prodotto. Riprovare. | |
| AggiornamentoNonAutorizzato | Non autorizzato ad aggiornare l'invio | Restituito quando si tenta di aggiornare un invio per un prodotto condiviso (resold) perché i prodotti condivisi non possono essere aggiornati. |
| AggiornamentoNonAutorizzato | Non è possibile aggiornare l'invio perché i flussi di lavoro non sono riusciti | Restituito quando si tenta di aggiornare un invio con un flusso di lavoro non riuscito. |
| EntitàNonTrovata | Nessun invio trovato | Restituito quando si tenta di eseguire il commit per un invio che non esiste. |
| EntitàNonTrovata | Prodotto non trovato | Restituito quando si tenta di creare un invio per il quale un prodotto non esiste. |
| Input non valido | I driver di estensione devono essere pubblicati come aggiornamento automatico. Uno dei due, "isAutoInstallDuringOSUpgrade" o "isAutoInstallOnApplicableSystems", deve essere true. | Restituito quando viene creata un'etichetta di spedizione degli aggiornamenti di Windows per un'estensione INF senza scegliere isAutoInstallDuringOSUpgrade o isAutoInstallOnApplicableSystems. |
| Input non valido | I CHID sono consentiti solo quando HardwareId sono per i sistemi operativi Windows 10 e versioni successive. | Restituito quando viene creata un'etichetta di spedizione destinata al sistema operativo inferiore a windows 10 con la destinazione CHID. Il targeting CHID è applicabile solo per Windows 10 e versioni successive. |
| Input non valido | Non è possibile aggiornare l'etichetta di spedizione quando è in corso un altro flusso di lavoro. Riprovare. | Restituito quando un'etichetta di spedizione viene aggiornata quando un flusso di lavoro precedente è ancora in corso. |
| RichiestaNonValidaPerStatoAttuale | Non è possibile creare l'etichetta di pubblicazione per la posta in arrivo o il tipo di sistema. È possibile condividere solo l'etichetta di spedizione. | Restituito quando l'etichetta di spedizione di Windows Update viene creata su un driver predefinito o su un sistema. |
| RichiestaNonValidaPerStatoAttuale | L'invio non è ancora pronto per la creazione di un'etichetta di spedizione. Ripetere l'operazione in un secondo momento. | Restituito quando viene creata un'etichetta di spedizione senza attendere il completamento della preparazione o della pre-elaborazione. |