Importare un aggiornamento in Aggiornamento dispositivi per hub IoT

Informazioni su come ottenere un nuovo aggiornamento e importarlo in Aggiornamento dispositivi per hub IoT. Se non è già stato fatto, assicurarsi di esaminare i concetti chiave relativi all'importazione e come preparare un aggiornamento da importare.

Prerequisiti

• Accesso a un IoT Hub con la funzionalità Aggiornamento del dispositivo abilitata per l'IoT Hub.
• Un dispositivo IoT (o simulatore) provvisto per Aggiornamento del dispositivo all'interno di IoT Hub.
• PowerShell 5 o versione successiva (include installazioni linux, macOS e Windows)
• Browser supportati:
  • Microsoft Edge
  • Google Chrome

Importare un aggiornamento

Annotazioni

Le istruzioni seguenti illustrano come importare un aggiornamento tramite l'interfaccia utente del portale di Azure. Puoi anche utilizzare le API di Aggiornamento Dispositivo per IoT Hub per importare un aggiornamento.

1. Accedi al portale di Azure e passa all'hub IoT con Aggiornamento dei dispositivi.

2. Sul lato sinistro della pagina selezionare Updates in Device Management.

   

3. Selezionare la Updates scheda dall'elenco delle schede nella parte superiore della schermata.

   

4. Selezionare + Import a new update sotto l'intestazione Available Updates .

   

5. Seleziona + Select from storage container. Viene visualizzata l'interfaccia utente degli account di archiviazione. Selezionare un account esistente oppure creare un account usando + Storage account. Questo account viene utilizzato per un contenitore di configurazione degli aggiornamenti per l'importazione.

   

6. Dopo aver selezionato un account di archiviazione, viene visualizzata l'interfaccia utente contenitori. Selezionare un contenitore esistente oppure creare un contenitore usando + Container. Questo contenitore viene usato per preparare i file di aggiornamento per l'importazione di raccomandazioni: usare un nuovo contenitore ogni volta che si importa un aggiornamento per evitare l'importazione accidentale di file dagli aggiornamenti precedenti. Se non si usa un nuovo contenitore, assicurarsi di eliminare eventuali file dal contenitore esistente prima di completare questo passaggio.

   

7. Nel contenitore selezionare Upload. Viene visualizzata l'interfaccia utente di caricamento.

   

8. Selezionare l'icona della cartella sul lato destro della Files sezione sotto l'intestazione Upload blob . Usare la selezione file per passare al percorso dei file di aggiornamento e importare il manifesto, selezionare tutti i file e quindi selezionare Open. È possibile tenere premuto MAIUSC e fare clic su per selezionare più file.

   

9. Dopo aver selezionato tutti i file di aggiornamento, selezionare Upload.

   

10. Selezionare i file caricati per designarli da importare. Fare quindi clic sul Select pulsante per tornare alla Import update pagina.

    

11. Nella pagina Aggiornamento dell'importazione, esaminare i file da importare. Selezionare Import update quindi per avviare il processo di importazione. Per risolvere eventuali errori, vedere la pagina Risoluzione dei problemi relativi all'aggiornamento proxy .

    

12. Il processo di importazione inizia e la schermata passa alla Import History sezione . Selezionare questa opzione per visualizzare Refresh lo stato di avanzamento fino al completamento del processo di importazione (a seconda delle dimensioni dell'aggiornamento, il processo potrebbe essere completato in pochi minuti, ma potrebbe richiedere più tempo).

    

13. Quando la Status colonna indica che l'importazione è riuscita, selezionare l'intestazione Available Updates . L'aggiornamento importato dovrebbe essere visualizzato nell'elenco.

    

Se invece stai eseguendo l'importazione tramite API

Oltre all'importazione tramite il portale di Azure, è anche possibile importare un aggiornamento a livello di codice tramite:

• Uso di Azure SDK per .NET, Java, JavaScript o Python
• Uso dell'API REST di importazione dell'aggiornamento
• Uso di moduli di PowerShell di esempio

Annotazioni

Per l'autorizzazione API necessaria, fare riferimento a Ruoli utente di aggiornamento del dispositivo e accesso .

I file di aggiornamento e il manifesto di importazione devono essere caricati in un contenitore di BLOB di Archiviazione di Azure per lo staging temporaneo. Per importare i file preparati, specificare l'URL del BLOB o la firma di accesso condiviso (SAS) per i BLOB privati nell'API di aggiornamento dispositivi. Se si utilizza una firma di accesso condiviso (SAS), fate attenzione a specificare una finestra di scadenza di almeno tre ore.

Suggerimento

Per caricare file di aggiornamento di grandi dimensioni nel contenitore BLOB di Archiviazione di Azure, puoi usare una delle opzioni seguenti per prestazioni migliori:

• AzCopy
• Azure Storage Explorer

Passaggi successivi

• Creare gruppi
• Informazioni sui concetti di importazione