Lavorare con AWS IoT in AWS Toolkit for Visual Studio Code - AWSToolkit for VS Code

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavorare con AWS IoT in AWS Toolkit for Visual Studio Code

AWS IoTnelAWS Toolkit for Visual Studio Codeconsente di interagire conAWS IoTservizio, riducendo al minimo le interruzioni del flusso di lavoro in VS Code. Questa guida per l'utente ha lo scopo di aiutarti a iniziare a utilizzareAWS IoTfunzionalità di servizio che sono disponibili nellaAWS Toolkit for Visual Studio Code. Per ulteriori informazioni sulAWS IoTservizio, consulta la guida per gli sviluppatoriChe cos'èAWS IoT?

Prerequisiti di AWS IoT

Per iniziare a utilizzareAWS IoTda Toolkit for VS Code, assicurati che il tuoAWSaccount e VS Code soddisfano i requisiti presenti nelle seguenti guide:

AWS IoTOggetti

AWS IoTcollega i dispositivi aAWSservizi e risorse cloud. È possibile collegare i dispositivi aAWS IoTutilizzando oggetti chiamaticose. Un oggetto è una rappresentazione di un'entità logica o un dispositivo specifico. Può trattarsi di un dispositivo fisico o un sensore, ad esempio una lampadina o un interruttore su un muro. Per ulteriori informazioni suAWS IoTcose, consulta la guida per gli sviluppatoriGestione di dispositivi conAWS IoT.

GestioneAWS IoTcose

Il Toolkit for VS Code ha diverse funzionalità che rendono il tuoAWS IoTgestione delle cose più efficiente. Questi sono modi in cui è possibile utilizzare il toolkit VS Code per gestire il tuoAWS IoToggetti:

Per creare un oggetto

  1. DaAWSExplorer, espandiIoTintestazione del servizio e selezione contestuale (pulsante destro del mouse)Oggetti.

  2. ScegliereCreazione di oggettidal menu contestuale per aprire una finestra di dialogo.

  3. Segui il prompt inserendo un nome per il tuo oggetto IoT nelNome oggetto.

  4. Quando questo è completo, aicona di oggettoseguito dal nome specificato sarà visibile nellaOggettosezione.

Per allegare un certificato a una cosa

  1. DaAWSExplorer, espandiIoTsezione service.

  2. InOggettisottosezione, individuare ilcosadove si sta allegando il certificato.

  3. Selezione contestuale (pulsante destro del mouse)cosae scegliCollegamento di un certificatodal menu contestuale, per aprire un selettore di input con un elenco dei certificati.

  4. Dall'elenco, scegliere laID del certificatoche corrisponde al certificato che vuoi allegare alla tua cosa.

  5. Una volta completato, il certificato è accessibile nelAWSesploratore, come elemento della cosa a cui l'hai collegato.

Per scollegare un certificato da una cosa

  1. DaAWSExplorer, espandiIoTsezione service

  2. NellaOggettisottosezione, individuare ilcosada cui si desidera distaccare un certificato.

  3. Selezione contestuale (pulsante destro del mouse)cosae scegliScollegare il certificatodal menu contestuale.

  4. Una volta completato, il certificato staccato non verrà più visualizzato sotto quella cosa nellaAWSExplorer, ma sarà comunque accessibile dalCertificatessottosezione.

Per eliminare un oggetto

  1. DaAWSExplorer, espandiIoTsezione service.

  2. NellaOggettisottosezione, individuare ilcosache desideri eliminare.

  3. Selezionare contestuale (pulsante destro del mouse) e scegliereElimina oggettodal menu contestuale per eliminarlo.

  4. Una volta completata, la cosa eliminata non sarà più disponibile dalOggettisottosezione.

    Nota

    Nota: È possibile eliminare solo una cosa a cui non è associato un certificato.

AWS IoTCertificati

I certificati sono un modo comune per creare una connessione sicura tra il tuoAWS IoTservizi e dispositivi. I certificati X.509 sono certificati digitali che usano lo standard di infrastruttura a chiave pubblica X.509 per associare una chiave pubblica a un'identità contenuta in un certificato. Per ulteriori informazioni suAWS IoTcertificati, consulta la guida per gli sviluppatoriAutenticazione (IoT).

Gestione dei certificati

Il toolkit VS Code offre una varietà di modi per gestire il tuoAWS IoTcertificati, direttamente dalAWSEspandere.

Per creare unAWS IoTcertificato

È possibile utilizzare un certificato X.509 per connettersi con l'istanza diAWS IoT.

  1. DaAWSExplorer, espandiIoTsezione service e contestuale (pulsante destro del mouse)Certificates.

  2. ScegliereCreare un certificatodal menu contestuale per aprire una finestra di dialogo.

  3. Selezionare una directory nel file system locale per salvare la key pair RSA e il certificato X.509.

    Nota
    • I nomi di file predefiniti contengono l'ID del certificato come prefisso.

    • Solo il certificato X.509 è archiviato con il tuoAWSaccount, attraverso ilAWS IoTservizio.

    • La key pair RSA può essere emessa una sola volta, salvandola in una posizione sicura nel file system quando viene richiesto.

    • Se il certificato o la key pair non possono essere salvati nel file system in questo momento,AWSToolkit elimina il certificato dal tuoAWSconto.

Per modificare lo stato di un certificato

Lo stato di un singolo certificato viene visualizzato accanto al relativo ID nellaAWSExplorer e può essere impostato su: attivo, inattivo o revocato.

Nota
  • Il certificato ha bisogno di unattivostato prima di poterlo utilizzare per collegare il dispositivo alAWS IoTservizio.

  • Un recordinattivoil certificato può essere attivato, sia che sia stato disattivato in precedenza o inattivo per impostazione predefinita.

  • Un certificato che è statorevocatanon può essere riattivato.

  1. DaAWSExplorer, espandiIoTsezione service.

  2. NellaCertificatessottosezione, individuare il certificato che si desidera modificare.

  3. Selezionare contestualmente (fare clic con il pulsante destro del mouse) sul certificato per aprire un menu contestuale che visualizza le opzioni di modifica dello stato disponibili per quel certificato.

  • Se un certificato ha lo statoinattivo, scegliattivatoper modificare lo stato di suattivo.

  • Se un certificato ha lo statoattivo, sceglidisattivareper modificare lo stato di suinattivo.

  • Se un certificato ha uno o piùattivooinattivostatus, sceglirevocareper modificare lo stato di surevocata.

Nota

Ognuna di queste azioni che cambiano lo stato è disponibile anche se si seleziona un certificato associato a un oggetto mentre viene visualizzato nellaOggettisottosezione.

Per allegare un criterio IoT a un certificato

  1. DaAWSExplorer, espandiIoTsezione service.

  2. NellaCertificatessottosezione, individuare il certificato che si desidera modificare.

  3. Selezionare contestuale (pulsante destro del mouse) e scegliereCollegamento di policydal menu contestuale, per aprire un selettore di input con un elenco dei criteri disponibili.

  4. Scegliere la policy che si desidera allegare al certificato.

  5. Al termine, il criterio selezionato verrà aggiunto al certificato come voce di sottomenu.

Per staccare un criterio IoT da un certificato

  1. DaAWSExplorer, espandiIoTsezione service.

  2. NellaCertificatessottosezione, individuare il certificato che si desidera modificare.

  3. Espandere il certificato e individuare la policy che si desidera scollegare.

  4. Context (pulsante destro del mouse) e scegliereDistaccadal menu contestuale.

  5. Una volta completata, la politica non sarà più un elemento accessibile dal certificato, ma sarà disponibile presso ilPolicysottosezione.

Eliminazione di un certificato

  1. DaAWSExplorer, espandiIoTintestazione di servizio.

  2. NellaCertificatessottosezione, individuare il certificato che si desidera eliminare.

  3. Selezionare contestuale (pulsante destro del mouse) e scegliereEliminazione deldal menu contestuale.

    Nota

    Non è possibile eliminare un certificato se è collegato a una cosa o ha uno stato attivo. È possibile eliminare un certificato con criteri allegati.

Policy AWS IoT

AWS IoTLe policy principali sono definite tramite documenti JSON, ciascuno contenente una o più dichiarazioni di policy. Le politiche definiscono comeAWS IoT,AWSe il dispositivo può interagire tra loro. Per ulteriori informazioni su come creare un documento di policy, consulta la guida per gli sviluppatoriPolicy IoT.

Nota

Le policy denominate sono modificate in modo da poterle ripristinare. Nel TheAWSExplorer, i criteri IoT sono elencati sottoPolicysottosezione, nel servizio IoT. È possibile visualizzare le versioni dei criteri espandendo un criterio. La versione predefinita è indicata da un asterisco.

Gestione di policy

Il Toolkit for VS Code offre diversi modi per gestire iAWS IoTpolicy di servizio. Questi sono modi in cui è possibile gestire o modificare le policy direttamente dalAWSExplorer in VS Code:

Per creare una policy AWS IoT

Nota

È possibile creare una nuova policy da AWS Explorer, ma il documento JSON che definisce il criterio deve già esistere nel file system.

  1. DaAWSExplorer, espandiIoTsezione service.

  2. Selezione contestuale (pulsante destro del mouse)Policysottosezione e scegliCreazione di criteri da documentoper aprireNome policyIl campo di input.

  3. Immettere un nome e seguire le istruzioni per aprire una finestra di dialogo che richiede di selezionare un documento JSON dal file system.

  4. Scegli il file JSON che contiene le definizioni dei criteri, il criterio sarà disponibile nelAWSexplorer quando è completo.

Per caricare un nuovoAWS IoTversione policy

È possibile creare una nuova versione di un criterio caricando un documento JSON nel criterio.

Nota

Il nuovo documento JSON deve essere presente sul file system per creare una nuova versione utilizzando ilAWSEspandere.

  1. DaAWSExplorer, espandiIoTsezione service.

  2. Espandere laPolicysottosezione per visualizzare ilAWS IoTnorme

  3. Selezionare contestuale (pulsante destro del mouse) la policy che si desidera aggiornare e scegliereCreare nuova versione da Document.

  4. Quando si apre la finestra di dialogo, scegliere il file JSON che contiene gli aggiornamenti delle definizioni dei criteri.

  5. La nuova versione sarà accessibile dalla tua policy nelAWSEspandere.

Per modificare unAWS IoTversione policy

Un documento criterio può essere aperto e modificato utilizzando VS Code. Una volta terminata la modifica del documento, è possibile salvarlo nel file system. Quindi, puoi caricarlo sul tuoAWS IoTservizio dalAWSEspandere.

  1. DaAWSExplorer, espandiIoTsezione service.

  2. Espandere laPolicysottosezione e individuazione della policy che si desidera aggiornare.Creazione di criteri da documentoper aprireNome policyIl campo di input.

  3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera modificare.

  4. ScegliereVisualizzazionedal menu contestuale per aprire la versione del criterio in VS Code

  5. Quando il documento criterio viene aperto, apportare e salvare le modifiche desiderate.

    Nota

    A questo punto, le modifiche apportate al criterio vengono salvate solo nel file system locale. Per aggiornare la versione e tracciarla conAWSExplorer, ripeti i passaggi descritti nellaUpload a new policy versionprocedura.

Per selezionare una nuova versione dei criteri predefinita

  1. DaAWSExplorer, espandiIoTsezione service.

  2. Espandere laPolicysottosezione e individuazione della policy che si desidera aggiornare.

  3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera impostare e scegliereImposta come impostazione predefinita.

  4. Una volta completata, la nuova versione predefinita selezionata avrà una stella accanto.

Per eliminare policy

Nota

Prima di poter eliminare un criterio o una versione dei criteri, è necessario soddisfare le condizioni.

  • Non è possibile eliminare una policy se è collegata a un certificato.

  • Non è possibile eliminare un criterio se ha versioni non predefinite.

  • Non è possibile eliminare la versione predefinita di un criterio a meno che non sia selezionata una nuova versione predefinita o l'intero criterio non venga eliminato.

  • Prima di poter eliminare un intero criterio, è necessario eliminare prima tutta la versione non predefinita di tale criterio.

  1. DaAWSExplorer, espandiIoTsezione service.

  2. Espandere laPolicysottosezione e individuazione della policy che si desidera aggiornare.

  3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera eliminare e scegliereElimina.

  4. Quando una versione viene eliminata, non sarà più visibile da Explorer.

  5. Quando l'unica versione rimasta per un criterio è quella predefinita, è possibile selezionare il contesto (fare clic con il pulsante destro del mouse) il criterio padre e scegliereEliminaper eliminarlo.