Condividi tramite

Ottenere i dati del prodotto

  • Articolo

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.

Method URI Descrizione
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/ Ottenere i dati per tutti i prodotti
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Ottenere dati per un prodotto specifico
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions Ottenere i dati per tutti gli invii di un prodotto
GET 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

Risorsa 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 prodotto privato del prodotto
sharedProductId Lungo ID prodotto condiviso del prodotto
Collegamenti matrice di oggetti Per altri dettagli, fare riferimento all'oggetto collegamento
isCommitted Booleano Indica se il prodotto ha almeno un invio di cui è stato eseguito il commit
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
deviceType String Indica il tipo di dispositivo. I valori possibili sono:
  • "interno" - Un componente interno, il dispositivo fa parte di un sistema e si connette all'interno del PC
  • "external" - Un componente esterno, un dispositivo è un dispositivo esterno (periferica) che si connette a un PC
  • "internalExternal" - Entrambi i dispositivi possono essere connessi internamente (all'interno di un PC) ed esternamente (periferiche)
  • "notSet" - Nessun dato disponibile
isTestSign Booleano Indica se il prodotto è un driver firmato da test. Per altre informazioni sui pacchetti driver di firma di test, vedere WHQL Test Signature Program
isFlightSign Booleano Indica se il prodotto è un driver firmato in anteprima. I driver firmati in anteprima sono driver di test 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
productName String Nome del driver come specificato durante la creazione
selectedProductTypes dizionario Coppia chiave-valore in cui entrambe sono stringhe.
  • Key rappresenta il codice della famiglia di sistemi operativi. Per un elenco dei codici della famiglia di sistemi operativi, vedere l'elenco dei codici della famiglia di sistemi operativi.
  • Value rappresenta il tipo del prodotto. Per un elenco di tipi di prodotti, vedere Tipi di prodotto.
requestedSignatures 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.
additionalAttributes Object Per altre informazioni, vedere l'oggetto attributi aggiuntivi.
testHarness string Tipo di pacchetto inviato. I valori possibili sono:
  • hlk
  • hck
  • attestation
  • notset
announcementDate datetime 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 long ID dell'invio
Productid long ID prodotto privato a cui è associato l'invio
workflowtatus 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 flusso di lavoro.
Collegamenti matrice di oggetti Per altri dettagli, fare riferimento all'oggetto collegamento
commitStatus Per altri dettagli, vedi Gestire gli invii di prodotti.
isExtensionInf Booleano Indica se l'invio è 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 string Nome dell'invio.
Type string Indica se l'invio è un invio iniziale o derivato. I valori possibili sono:
  • iniziale
  • derivati
download oggetto Questa opzione è disponibile solo quando si recuperano i dettagli di un invio specifico. Questo oggetto illustra i download disponibili per l'invio. Per altre informazioni, vedere l'oggetto download.

Oggetto Stato 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
currentStep string Nome del passaggio corrente nel flusso di lavoro complessivo per questa entità.
Per l'invio di inserimento/pacchetto, i valori possibili sono (descrizione tra parentesi):
  • packageInfoValidation (convalida dei metadati e del contenuto del pacchetto)
  • preparazione (preparazione del pacchetto per l'elaborazione)
  • scansione (analisi del contenuto del pacchetto per malware)
  • convalida (convalida dei risultati dei test)
  • catalogCreation (Creazione di un catalogo di sicurezza per il pacchetto)
  • manualReview (in fase di revisione manuale)
  • firma (firma dei file binari)
  • finalizeIngestion (Completamento dell'inserimento e preparazione dei file firmati per il download o la pubblicazione)
Provincia string Stato del passaggio corrente. I valori possibili sono:
  • notStarted
  • avviata
  • failed
  • completato
Messaggi array 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"
    }
  ],
  "messages": []
}

Questo oggetto ha i valori seguenti

Valore Tipo Descrizione
Articoli array Matrice di tipi di download e URL per ognuno di essi.
Type string Tipo di pacchetto disponibile per il download. I valori possibili sono:
  • "initialPackage" : pacchetto caricato dall'utente (per un nuovo invio, punta all'URI di firma di accesso condiviso per caricare il pacchetto)
  • "derivedPackage" – shell per gli invii derivati
  • "signedPackage" - pacchetto firmato da Microsoft
  • "certificationReport" – report di certificazione per il prodotto firmato
  • driverMetadata: consente di collegare un file che consente di scaricare i metadati del driver. Per altre informazioni, vedere Metadati del pacchetto driver.
  • ExternalNotes
  • Sconosciuto
Messaggi array Matrice di stringhe per fornire messaggi sui file scaricabili

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 String URL per accedere alla risorsa tramite l'API
Rel String Tipo di risorsa. I valori possibili sono:
  • self - Collega punti a se stesso
  • next_link: collega i punti alla risorsa successiva in genere usata per la paginazione
  • get_submissions : punti di collegamento a tutti gli invii di un prodotto
  • commit_submission : punti di collegamento per il commit di un invio
  • update_submission : punti di collegamento per l'aggiornamento dell'invio
  • update_shippinglabel : punti di collegamento da aggiornare dell'etichetta di spedizione
metodo String Tipo del metodo http da usare quando si richiama l'URL. I valori possibili sono:
  • GET
  • POST
  • PATCH

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
biosVersion string VERSIONE BIOS ROM
firmwareVersion string Versione del firmware
driverVersion string Versione driver
driverName string Nome driver
deviceVersion string Versione del dispositivo
chipsetName string Nome chipset
usedProprietary boolean Multi-pathing supportato tramite driver proprietario. Se true, proprietariaName e proprietarioVersion sono obbligatori.
proprietaryName string Nome software multi-percorso
proprietarioVersion string Versione del software multi-percorso
usedMicrosoft boolean Microsoft MPIO supportato tramite un modulo specifico del dispositivo. Se true, microsoftName e microsoftVersion sono obbligatori.
microsoftName string Nome software multi-percorso
microsoftVersion string Versione del software multi-percorso
usedBootSupport boolean Supporto per l'avvio
usedBetterBoot boolean Supporto di avvio > da 2,2 TB. Se true, la versione UEFI supportata e la versione ACPI supportata sono obbligatorie
uefiVersion string Versione UEFI supportata
acpiVersion string Versione ACPI supportata
supportsSector4K512E boolean Dimensioni del settore di supporto di 4K/512e
supportsSector4K4K4K boolean Dimensioni del settore di supporto di 4K/4K
supportsDifferential boolean Differenziale (differenziale ad alta tensione)

Oggetto RaidController

Valore Tipo Descrizione
firmwareVersion string Versione del firmware
filterVersion string Versione driver
driverVersion string Versione filtro
usedProprietary boolean Multi-pathing supportato tramite driver proprietario. Se true, proprietariaName e proprietarioVersion sono obbligatori
proprietaryName string Nome software multi-percorso
proprietarioVersion string Versione del software multi-percorso
usedMicrosoft boolean Microsoft MPIO supportato tramite un modulo specifico del dispositivo. Se true, microsoftName e microsoftVersion sono obbligatori
microsoftName string Nome software multi-percorso
microsoftVersion string Versione del software multi-percorso
isThirdPartyNeeded boolean Driver non Microsoft necessario per la connettività
isSES boolean 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 boolean SAF-TE (specifica ANBll). Indica se è incluso un OGGETTO SAF-TE. ANBll una specifica del settore. SAF-TE è l'abbreviazione di enclosure a tolleranza di errore a SCSI a tolleranza di errore. SCSI è il termine standard per un bus di servizio che connette i dispositivi in un sistema, originariamente Small Computer System Interface.
additionalInfo string Informazioni aggiuntive

Oggetto SVVP

Valore Tipo Descrizione
productVersion string Versione prodotto
supportLink string URL del supporto
guestOs string Sistema operativo guest. I valori possibili sono:
  • Windows Server 2008
  • Windows Server 2008 Versione 2
  • Windows Server 2012
  • Windows Server 2012 R2
processorArchitecture string Architettura del processore hardware. I valori possibili sono:
  • Xeon
  • Opteron
  • Itanium 2
maxProcessor integer Numero massimo di processori nella macchina virtuale
maxMemory integer 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
  • Cluster
  • Acceleratore di calcolo MCDM 2.7
  • Acceleratore di calcolo MCDM 3.1
  • Acceleratore di calcolo MCDM 3.2
  • Tablet convertibile
  • Desktop
  • Renderer multimediale digitale
  • Digital Media Server
  • Fotocamere digitali ancora digitali
  • Fotocamere digitali
  • Dispositivi abilitati per la gestione dell'analisi di distribuzione
  • Stampante multi-funzione WSD Enterprise
  • 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
  • Scheda grafica WDDM1.1
  • Scheda grafica WDDM1.2
  • Scheda grafica WDDM1.2 DisplayOnly
  • Scheda grafica WDDM1.2 RenderOnly
  • Scheda grafica WDDM1.3
  • Scheda grafica WDDM1.3 DisplayOnly
  • Scheda grafica WDDM1.3 RenderOnly
  • Scheda grafica WDDM2.0
  • Scheda grafica WDDM2.0 Solo schermo
  • Adattatore grafica WDDM2.0 Solo rendering
  • Scheda grafica WDDM2.1
  • Scheda grafica WDDM2.1 Solo schermo
  • Adattatore grafica WDDM2.1 Solo rendering
  • Adattatore grafico WDDM2.2
  • Scheda grafica WDDM2.2 Solo schermo
  • Solo rendering wdDM2.2 della scheda grafica
  • Adattatore grafico WDDM2.3
  • Scheda grafica WDDM2.3 Solo schermo
  • Solo rendering wdDM2.3 della scheda grafica
  • Scheda grafica WDDM2.4
  • Scheda grafica WDDM2.4 Solo schermo
  • Adattatore grafica WDDM2.4 Solo rendering
  • Scheda grafica WDDM2.4 VM
  • Adattatore grafico WDDM2.5
  • Scheda grafica WDDM2.5 Solo schermo
  • Solo rendering wdDM2.5 della scheda grafica
  • Scheda grafica WDDM2.5 VM
  • Scheda grafica WDDM2.6
  • Scheda grafica WDDM2.6 Solo schermo
  • Solo rendering wdDM2.6 della scheda grafica
  • Scheda grafica WDDM2.6 VM
  • Adattatore grafico WDDM2.7
  • Solo schermo WDDM2.7 della scheda grafica
  • Solo rendering wdDM2.7 della scheda grafica
  • Scheda grafica WDDM2.7 VM
  • Scheda grafica WDDM2.8
  • Scheda grafica WDDM2.8 Solo schermo
  • Solo rendering wdDM2.8 della scheda grafica
  • Scheda grafica WDDM2.8 VM
  • Adattatore grafico WDDM2.9
  • Scheda grafica WDDM2.9 Solo schermo
  • Adattatore grafica WDDM2.9 Solo 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
  • Scheda grafica WDDM3.1 Solo schermo
  • Adattatore grafica WDDM3.1 Solo rendering
  • Scheda grafica WDDM3.1 VM
  • Scheda grafica WDDM3.2
  • Scheda grafica WDDM3.2 Solo schermo
  • Adattatore grafica 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
  • LAN (server)
  • LAN CS
  • Macchina virtuale LAN (server)
  • Portatile
  • Portatile con tocco
  • LCD
  • Sensore chiaro
  • Sensore di posizione
  • Media Player
  • Mobile Broadband CDMA
  • Mobile Broadband GSM
  • Cellulare
  • Monitoraggio
  • Scheda madre
  • Fusione del sensore di movimento
  • Stampante a più funzioni
  • Prossimità campo vicino
  • Dispositivo multimediale di rete
  • NFC
  • Lettore smart card NFC
  • Unità ottica
  • Digitalizzatore penna
  • Disegno di puntamento
  • PrecisionTouchpad
  • Sensore presenza
  • Stampante
  • Proiettore
  • Archivi rimovibili
  • Router
  • Scanner
  • SDIO Controller
  • Server
  • Programma di convalida della virtualizzazione server
  • Tablet firma
  • Smart card
  • Lettore smart card
  • Array di archiviazione
  • Controller di archiviazione
  • Adapter Spazi di archiviazione
  • unità Spazi di archiviazione
  • Tablet
  • Touch
  • Touch Monitor
  • TPM20
  • Ultra-Mobile PC
  • Ultra-Mobile PC con Tocco
  • 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 Windows Home Server
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 Windows Server Threshold
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

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 Windows Vista Client
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 Windows Home Server
WINDOWS_7 Windows 7 Client
WINDOWS_7_X64 Client 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 Soluzioni Windows Server x64
WINDOWS_8 Client Windows 8
WINDOWS_8_X64 Client Windows 8 x64
WINDOWS_8_ARM Windows 8 Client RT
WINDOWS_8_SERVER_X64 Windows Server 2012
WINDOWS_v63 Windows 8.1 Client
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 Windows 19H1 Client 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

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
InvalidInput Restituito quando una convalida di input ha esito negativo.
RequestInvalidForCurrentState È possibile eseguire il commit solo degli invii in sospeso Restituito quando un commit viene applicato a un invio che non è in sospeso.
RequestInvalidForCurrentState L'invio iniziale esiste già Restituito quando viene creato un invio iniziale per un driver che ha già un invio iniziale.
RequestInvalidForCurrentState 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.
UpdateUnauthorized Non autorizzato ad aggiornare il prodotto Restituito quando si tenta di aggiornare un prodotto condiviso (rildo) perché non è possibile aggiornare i prodotti condivisi.
UpdateUnauthorized Non è possibile aggiornare il prodotto senza un invio iniziale Restituito quando si tenta di aggiornare un prodotto che non ha un invio iniziale.
UpdateUnauthorized 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.
UpdateUnauthorized Data annuncio non può essere aggiornata al termine del processo di inserimento Restituito quando la data dell'annuncio viene aggiornata dopo il completamento dell'inserimento.
UpdateUnauthorized Al momento non è possibile aggiornare il nome del prodotto. Riprovare.
UpdateUnauthorized 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.
UpdateUnauthorized 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.
EntityNotFound Nessun invio trovato Restituito quando si tenta di eseguire il commit per un invio che non esiste.
EntityNotFound Prodotto non trovato Restituito quando si tenta di creare un invio per il quale un prodotto non esiste.
InvalidInput 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.
InvalidInput 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. La destinazione CHID è applicabile solo per Windows 10 e versioni successive.
InvalidInput 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.
RequestInvalidForCurrentState 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 in un driver posta in arrivo o in un sistema.
RequestInvalidForCurrentState L'invio non è ancora pronto per creare 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.

Vedi anche