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à.

# AWS-componenti forniti
<a name="public-components"></a>

AWS IoT Greengrass fornisce e gestisce componenti predefiniti che è possibile distribuire sui dispositivi. Questi componenti includono funzionalità (come lo stream manager), connettori AWS IoT Greengrass V1 (come le CloudWatch metriche) e strumenti di sviluppo locale (come la CLI AWS IoT Greengrass ). Puoi [distribuire questi componenti](manage-deployments.md) sui tuoi dispositivi per la loro funzionalità autonoma oppure puoi usarli come dipendenze nei componenti [Greengrass](develop-greengrass-components.md) personalizzati.

**Nota**  <a name="component-nucleus-dependency-update-note"></a>
Diversi componenti AWS forniti dipendono da versioni minori specifiche del nucleo Greengrass. A causa di questa dipendenza, è necessario aggiornare questi componenti quando si aggiorna il nucleo di Greengrass a una nuova versione secondaria. Per informazioni sulle versioni specifiche del nucleo da cui dipende ogni componente, consultate l'argomento relativo ai componenti. Per ulteriori informazioni sull'aggiornamento del nucleo, vedere. [Aggiornamento del software AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md)

<a name="component-table-type-description"></a>Quando un componente ha un tipo di componente sia generico che Lambda, la versione corrente del componente è di tipo generico e una versione precedente del componente è di tipo Lambda.


| Componente | Description | [Tipo di componente](develop-greengrass-components.md#component-types) | Sistema operativo supportato | [Open source](open-source.md) | Compatibile con Nucleus lite | 
| --- | --- | --- | --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | Il nucleo del software AWS IoT Greengrass Core. Usa questo componente per configurare e aggiornare il software sui tuoi dispositivi principali. | Nucleo | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-nucleus) | No | 
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | Un nucleo leggero per dispositivi con risorse limitate, ottimizzato per dispositivi edge a basso costo e applicazioni ad alto volume | NucleusLite | Linux | [Sì](https://github.com/aws-greengrass/aws-greengrass-lite) | No | 
| <a name="client-device-auth-component-table-row"></a>[Autenticazione del dispositivo client](client-device-auth-component.md) | Consente ai dispositivi IoT locali, chiamati dispositivi client, di connettersi al dispositivo principale. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-client-device-auth) | No | 
| [CloudWatch metriche](cloudwatch-metrics-component.md) | Pubblica metriche personalizzate su Amazon. CloudWatch | Generico, Lambda | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-cloudwatch-metrics) | Sì | 
| [AWS IoT Device Defender](device-defender-component.md) | Notifica agli amministratori le modifiche allo stato del dispositivo principale Greengrass per identificare comportamenti insoliti. | Generico, Lambda | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-device-defender) | No | 
| [Spooler del disco](disk-spooler-component.md) | Abilita un'opzione di archiviazione persistente per i messaggi trasmessi dai dispositivi core Greengrass a. AWS IoT Core Questo componente memorizzerà questi messaggi in uscita su disco. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-disk-spooler) | No | 
| [Gestore di applicazioni Docker](docker-application-manager-component.md) | Consente di AWS IoT Greengrass scaricare immagini Docker da Docker Hub e Amazon Elastic Container Registry (Amazon ECR). | Generico | Linux, Windows | No | No | 
| [Connettore Edge per Kinesis Video Streams](kvs-edge-connector-component.md) | Legge i feed video dalle telecamere locali, pubblica gli stream su Kinesis Video Streams e li visualizza nelle dashboard Grafana con. AWS IoT TwinMaker | Generico | Linux | No | No | 
| [Greengrass CLI](greengrass-cli-component.md) | Fornisce un'interfaccia a riga di comando che è possibile utilizzare per creare distribuzioni locali e interagire con il dispositivo principale Greengrass e i suoi componenti. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-cli) | [No](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/ggl-cli.md) | 
| <a name="ip-detector-component-table-row"></a>[Rilevatore IP](ip-detector-component.md) | Riporta le informazioni sulla connettività del broker MQTT a AWS IoT Greengrass, in modo che i dispositivi client possano scoprire come connettersi. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-ip-detector) | No | 
| [Firehose](kinesis-firehose-component.md) | Pubblica i dati tramite i flussi di distribuzione di Amazon Data Firehose verso destinazioni in. Cloud AWS | Lambda | Linux | No | No | 
| [Lanciatore Lambda](lambda-launcher-component.md) | Gestisce i processi e la configurazione dell'ambiente per le funzioni Lambda. | Generico | Linux | No | No | 
| [Gestore Lambda](lambda-manager-component.md) | Gestisce la comunicazione tra processi e la scalabilità per le funzioni Lambda. | Plug-in | Linux | No | No | 
| [Runtime Lambda](lambda-runtimes-component.md) | Fornisce artefatti per ogni runtime Lambda. | Generico | Linux | No | No | 
| [Router di abbonamento legacy](legacy-subscription-router-component.md) | Gestisce gli abbonamenti per le funzioni Lambda eseguite AWS IoT Greengrass su V1. | Generico | Linux | No | No | 
| [Console di debug locale](local-debug-console-component.md) | Fornisce una console locale che è possibile utilizzare per eseguire il debug e gestire il dispositivo principale Greengrass e i suoi componenti. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-localdebugconsole) | No | 
| [Gestore dei registri](log-manager-component.md) | Raccoglie e carica i log sul dispositivo principale Greengrass. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-log-manager) | No | 
| [Componenti per l'apprendimento automatico](machine-learning-components.md) | Fornisce modelli di apprendimento automatico e codice di inferenza di esempio che è possibile utilizzare per eseguire inferenze di apprendimento automatico sui dispositivi core Greengrass. | Per informazioni, consulta [Componenti per l'apprendimento automatico](machine-learning-components.md). | No | 
| [Adattatore di protocollo Modbus-RTU](modbus-rtu-protocol-adapter-component.md) | Esamina le informazioni dai dispositivi Modbus RTU locali. | Lambda | Linux | No | No | 
| [Emettitore di telemetria Nucleus](nucleus-emitter-component.md) | Pubblica i dati di telemetria sanitaria del sistema raccolti dal nucleo su un argomento locale o su un argomento MQTT. AWS IoT Core  | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-telemetry-nucleus-emitter) | No | 
| <a name="mqtt-bridge-component-table-row"></a>[Ponte MQTT](mqtt-bridge-component.md) | Inoltra messaggi MQTT tra dispositivi client, pubblicazione/sottoscrizione locale e. AWS IoT Greengrass AWS IoT Core | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-mqtt-bridge) | No | 
| <a name="mqtt-broker-moquette-component-table-row"></a>[Broker MQTT 3.1.1 (Moquette)](mqtt-broker-moquette-component.md) | Esegue un broker MQTT 3.1.1 che gestisce i messaggi tra i dispositivi client e il dispositivo principale. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-moquette-mqtt) | No | 
| <a name="mqtt-broker-emqx-component-table-row"></a>[Broker MQTT 5 (EMQX)](mqtt-broker-emqx-component.md) | Esegue un broker MQTT 5 che gestisce i messaggi tra i dispositivi client e il dispositivo principale. | Generico | Linux, Windows | No | No | 
| [Fornitore PKCS \$111](pkcs11-provider-component.md) | Consente ai componenti Greengrass di accedere a una chiave privata e a un certificato archiviati in modo sicuro in un modulo di sicurezza hardware (HSM). | Plug-in | Linux | [Sì](https://github.com/aws-greengrass/aws-greengrass-pkcs11-provider) | No | 
| [Gestore segreto](secret-manager-component.md) | Distribuisce i segreti dai Gestione dei segreti AWS segreti in modo da poter utilizzare in modo sicuro le credenziali, come le password, nei componenti personalizzati del dispositivo principale Greengrass. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-secret-manager) | No | 
| [Tunneling sicuro](secure-tunneling-component.md) | Consente connessioni di tunneling AWS IoT sicure che è possibile utilizzare per stabilire comunicazioni bidirezionali con i dispositivi core Greengrass protetti da firewall limitati. | Generico | Linux | No | Sì | 
| <a name="shadow-manager-component-table-row"></a>[Gestore delle ombre](shadow-manager-component.md) | Consente l'interazione con le ombre sul dispositivo principale. Gestisce l'archiviazione dei documenti shadow e anche la sincronizzazione degli stati shadow locali con il servizio AWS IoT Device Shadow. | Plug-in | Linux, Windows | [Sì](https://github.com/aws-greengrass/aws-greengrass-shadow-manager) | No | 
| [Amazon SNS](sns-component.md) | Pubblica messaggi su argomenti di Amazon SNS. | Lambda | Linux | No | No | 
| [Stream manager](stream-manager-component.md) | Trasmette dati ad alto volume da fonti locali a. Cloud AWS | Generico | Linux, Windows | No | Sì | 
| [Inoltro di log di sistema](system-log-forwarder-component.md) | Carica i log di systemd-journald su. Cloud AWS | Generico | Linux | [Sì](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) | Sì | 
| [Agente Systems Manager](systems-manager-agent-component.md) | Gestisci il dispositivo principale con AWS Systems Manager, che ti consente di applicare patch ai dispositivi, eseguire comandi e altro ancora. | Generico | Linux | [Sì](https://github.com/aws/amazon-ssm-agent/blob/mainline/packaging/greengrass/component.json) | No | 
| [Servizio di scambio di token](token-exchange-service-component.md) | Fornisce AWS credenziali che è possibile utilizzare per interagire con AWS i servizi. | Generico | Linux, Windows | No | No | 
| [Collettore IoT SiteWise OPC UA](iotsitewise-opcua-collector-component.md) | Raccoglie dati dai server OPC-UA. | Generico | Linux, Windows | No | No | 
| [Simulatore di sorgenti dati IoT SiteWise OPC UA](iotsitewise-opcua-data-source-simulator-component.md) | Esegue un server OPC-UA locale che genera dati di esempio. | Generico | Linux, Windows | No | No | 
| [SiteWise Editore IoT](iotsitewise-publisher-component.md) | Pubblica dati nel AWS cloud. | Generico | Linux, Windows | No | No | 
| [SiteWise Processore IoT](iotsitewise-processor-component.md) | Elabora i dati sui dispositivi principali Greengrass. | Generico | Linux, Windows | No | No | 

# Nucleo Greengrass
<a name="greengrass-nucleus-component"></a>

Il componente Greengrass nucleus (`aws.greengrass.Nucleus`) è un componente obbligatorio e il requisito minimo per eseguire il software AWS IoT Greengrass Core su un dispositivo. È possibile configurare questo componente per personalizzare e aggiornare il software AWS IoT Greengrass Core da remoto. Implementa questo componente per configurare impostazioni come proxy, ruolo del dispositivo e configurazione degli AWS IoT oggetti sui tuoi dispositivi principali.

**Nota**  
A partire dalla versione 2.14.0 di Greengrass, è disponibile una versione ottimizzata per l'ingombro di memoria del runtime del dispositivo nucleus per i dispositivi edge con vincoli. Vedi [Greengrass nucleus lite](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) per ulteriori informazioni sulla sua configurazione e utilizzo.

**Importante**  
Quando la versione del componente nucleus cambia o quando modifichi determinati parametri di configurazione, il software AWS IoT Greengrass Core, che include il nucleus e tutti gli altri componenti del dispositivo, si riavvia per applicare le modifiche.   
<a name="component-patch-update"></a>Quando distribuisci un componente, AWS IoT Greengrass installa le ultime versioni supportate di tutte le dipendenze del componente. Per questo motivo, le nuove versioni patch dei componenti pubblici AWS forniti potrebbero essere distribuite automaticamente sui dispositivi principali se si aggiungono nuovi dispositivi a un gruppo di oggetti o si aggiorna la distribuzione destinata a tali dispositivi. Alcuni aggiornamenti automatici, come un aggiornamento Nucleus, possono causare il riavvio imprevisto dei dispositivi.   
<a name="component-version-pinning"></a>[Per evitare aggiornamenti involontari per un componente in esecuzione sul tuo dispositivo, ti consigliamo di includere direttamente la versione preferita di quel componente quando crei una distribuzione.](create-deployments.md) Per ulteriori informazioni sul comportamento di aggiornamento per il software AWS IoT Greengrass Core, consulta[Aggiornamento del software AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md).

**Topics**
+ [Versioni](#greengrass-nucleus-component-versions)
+ [Requisiti per il dispositivo](#greengrass-v2-requirements)
+ [Piattaforme supportate](#greengrass-v2-supported-platforms)
+ [Sistema operativo](#greengrass-nucleus-component-os-support)
+ [Requisiti](#greengrass-nucleus-component-requirements)
+ [Dipendenze](#greengrass-nucleus-component-dependencies)
+ [Download e installazione](#greengrass-nucleus-component-install)
+ [Configurazione](#greengrass-nucleus-component-configuration)
+ [File di registro locale](#greengrass-nucleus-component-log-file)
+ [Changelog](#greengrass-nucleus-component-changelog)

## Versioni
<a name="greengrass-nucleus-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.16.x
+ 2.15x
+ 2.14x
+ 2.13x
+ 2.12x
+ 2.11. x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2,5. x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Requisiti per il dispositivo
<a name="greengrass-v2-requirements"></a>

**Nota**  
Puoi utilizzare AWS IoT Device Tester for per AWS IoT Greengrass verificare che il tuo dispositivo sia in grado di eseguire il software AWS IoT Greengrass Core e comunicare con. Cloud AWS Per ulteriori informazioni, consulta [Utilizzo AWS IoT Device Tester per AWS IoT Greengrass V2](device-tester-for-greengrass-ug.md).

------
#### [ Linux ]
+ <a name="requirement-supported-region"></a>L'uso di un dispositivo [Regione AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)che supporta AWS IoT Greengrass V2. Per l'elenco delle regioni supportate, consulta [Endpoint e quote AWS IoT Greengrass V2](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) in *Riferimenti generali di AWS*.
+ Almeno 256 MB di spazio su disco disponibile per il software AWS IoT Greengrass Core. Questo requisito non include i componenti distribuiti sul dispositivo principale.
+ Almeno 96 MB di RAM assegnati al software AWS IoT Greengrass Core. Questo requisito non include i componenti che funzionano sul dispositivo principale. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).
+ Java Runtime Environment (JRE) versione 8 o successiva. Java deve essere disponibile nella variabile di ambiente [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) del dispositivo. Per utilizzare Java per sviluppare componenti personalizzati, è necessario installare un Java Development Kit (JDK). Ti consigliamo di utilizzare le versioni di supporto a lungo termine di [Amazon Corretto](https://aws.amazon.com/corretto/) o [OpenJDK](https://openjdk.java.net/). È richiesta la versione 8 o successiva.
+ [GNU C Library](https://www.gnu.org/software/libc/) (glibc) versione 2.25 o successiva.
+ È necessario eseguire il software AWS IoT Greengrass Core come utente root. Usa`sudo`, ad esempio.
+ L'utente root che esegue il software AWS IoT Greengrass Core, ad esempio`root`, deve avere il permesso di funzionare `sudo` con qualsiasi utente e gruppo. Il `/etc/sudoers` file deve concedere a questo utente l'autorizzazione a funzionare `sudo` come altri gruppi. L'autorizzazione per l'utente `/etc/sudoers` dovrebbe essere simile all'esempio seguente.

  ```
  root    ALL=(ALL:ALL) ALL
  ```
+ Il dispositivo principale deve essere in grado di eseguire richieste in uscita verso un insieme di endpoint e porte. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).
+ La `/tmp` directory deve essere montata con `exec` le autorizzazioni.
+ Tutti i seguenti comandi di shell:
  + `ps -ax -o pid,ppid`
  + `sudo`
  + `sh`
  + `kill`
  + `cp`
  + `chmod`
  + `rm`
  + `ln`
  + `echo`
  + `exit`
  + `id`
  + `uname`
  + `grep`
+ Il dispositivo potrebbe richiedere anche i seguenti comandi shell opzionali:
  + (Facoltativo)`systemctl`. Questo comando viene utilizzato per configurare il software AWS IoT Greengrass Core come servizio di sistema.
  + (`useradd`Facoltativo`groupadd`) e`usermod`. Questi comandi vengono utilizzati per configurare l'`ggc_user`utente e il gruppo `ggc_group` di sistema.
  + (Facoltativo)`mkfifo`. Questo comando viene utilizzato per eseguire funzioni Lambda come componenti.
+ Per configurare i limiti delle risorse di sistema per i processi dei componenti, il dispositivo deve eseguire la versione del kernel Linux 2.6.24 o successiva.
+ Per eseguire le funzioni Lambda, il dispositivo deve soddisfare requisiti aggiuntivi. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).

------
#### [ Windows ]
+ <a name="requirement-supported-region"></a>L'uso di un dispositivo [Regione AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)che supporti AWS IoT Greengrass V2. Per l'elenco delle regioni supportate, consulta [Endpoint e quote AWS IoT Greengrass V2](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) in *Riferimenti generali di AWS*.
+ Almeno 256 MB di spazio su disco disponibile per il software AWS IoT Greengrass Core. Questo requisito non include i componenti distribuiti sul dispositivo principale.
+ Almeno 160 MB di RAM assegnati al software AWS IoT Greengrass Core. Questo requisito non include i componenti che funzionano sul dispositivo principale. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).
+ Java Runtime Environment (JRE) versione 8 o successiva. Java deve essere disponibile nella variabile di sistema [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) del dispositivo. Per utilizzare Java per sviluppare componenti personalizzati, è necessario installare un Java Development Kit (JDK). Ti consigliamo di utilizzare le versioni di supporto a lungo termine di [Amazon Corretto](https://aws.amazon.com/corretto/) o [OpenJDK](https://openjdk.java.net/). È richiesta la versione 8 o successiva. 
**Nota**  
Per utilizzare la versione 2.5.0 del nucleo [Greengrass](#greengrass-nucleus-component), è necessario utilizzare una versione a 64 bit di Java Runtime Environment (JRE). La versione 2.5.1 di Greengrass nucleus supporta 32 bit e 64 bit. JREs
+ L'utente che installa il software AWS IoT Greengrass Core deve essere un amministratore.
+ È necessario installare il software AWS IoT Greengrass Core come servizio di sistema. Specificare `--setup-system-service true` quando si installa il software.
+ Ogni utente che esegue i processi dei componenti deve esistere nell' LocalSystem account e il nome e la password dell'utente devono trovarsi nell'istanza di Credential Manager dell' LocalSystem account. Puoi configurare questo utente seguendo le istruzioni per [installare il software AWS IoT Greengrass Core](install-greengrass-core-v2.md).
+ Il dispositivo principale deve essere in grado di eseguire richieste in uscita verso un insieme di endpoint e porte. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).

------

## Piattaforme supportate
<a name="greengrass-v2-supported-platforms"></a>

AWS IoT Greengrass supporta ufficialmente i dispositivi che eseguono le seguenti piattaforme. I dispositivi con piattaforme non incluse in questo elenco potrebbero funzionare, ma AWS IoT Greengrass i test vengono eseguiti solo su queste piattaforme specificate.

------
#### [ Linux ]

Architetture:
+ Armv7l
+ Arm v8 () AArch64
+ x86\$164

------
#### [ Windows ]

Architetture:
+ x86\$164

Versioni:
+ Windows 10
+ Windows 11
+ Windows Server 2019
+ Windows Server 2022

**Nota**  
Alcune AWS IoT Greengrass funzionalità non sono attualmente supportate nei dispositivi Windows. Per ulteriori informazioni, consultare [Compatibilità delle funzionalità Greengrass](operating-system-feature-support-matrix.md) e [Considerazioni sulle funzionalità](#greengrass-v2-windows-feature-considerations).

------

### Considerazioni sulle funzionalità
<a name="greengrass-v2-windows-feature-considerations"></a>

Alcune AWS IoT Greengrass funzionalità non sono attualmente supportate nei dispositivi Windows. Esamina le differenze tra le funzionalità per confermare se un dispositivo Windows soddisfa i tuoi requisiti. Per ulteriori informazioni, consulta [Compatibilità delle funzionalità Greengrass](operating-system-feature-support-matrix.md).

[Per creare un sistema operativo personalizzato basato su Linux, puoi usare la BitBake ricetta del progetto. AWS IoT Greengrass`meta-aws`](https://github.com/aws/meta-aws/tree/master/recipes-iot) Il `meta-aws` progetto fornisce ricette che è possibile utilizzare per sviluppare funzionalità software AWS all'avanguardia in sistemi [Linux integrati](https://elinux.org/) costruiti con [OpenEmbedded](https://www.openembedded.org/wiki/Main_Page)framework di compilazione Yocto Project. Il progetto [Yocto è un progetto](https://www.yoctoproject.org/) di collaborazione open source che consente di creare sistemi personalizzati basati su Linux per applicazioni integrate indipendentemente dall'architettura hardware. La BitBake ricetta per AWS IoT Greengrass installare, configurare ed eseguire automaticamente il software Core sul dispositivo. AWS IoT Greengrass 

Le piattaforme Linux possono essere eseguite anche AWS IoT Greengrass in un contenitore Docker. Per ulteriori informazioni, consulta [Esegui il software AWS IoT Greengrass Core in un contenitore Docker](run-greengrass-docker.md). 

## Sistema operativo
<a name="greengrass-nucleus-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

Per ulteriori informazioni, consulta [Piattaforme supportate](#greengrass-v2-supported-platforms).

## Requisiti
<a name="greengrass-nucleus-component-requirements"></a>

I dispositivi devono soddisfare determinati requisiti per installare ed eseguire il Greengrass nucleus e il AWS IoT Greengrass software Core. Per ulteriori informazioni, consulta [Requisiti per il dispositivo](#greengrass-v2-requirements).

Il componente Greengrass nucleus è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
+ Il componente Greengrass nucleus deve avere connettività a AWS IoT data, AWS IoT Credentials e Amazon S3.

## Dipendenze
<a name="greengrass-nucleus-component-dependencies"></a>

Il nucleo Greengrass non include alcuna dipendenza dai componenti. Tuttavia, diversi componenti AWS forniti includono il nucleo come dipendenza. Per ulteriori informazioni, consulta [AWS-componenti forniti](public-components.md).

[Per ulteriori informazioni sulle dipendenze dei componenti, consulta il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Download e installazione
<a name="greengrass-nucleus-component-install"></a>

Puoi scaricare un programma di installazione che configura il componente Greengrass nucleus sul tuo dispositivo. Questo programma di installazione configura il dispositivo come dispositivo principale Greengrass. È possibile eseguire due tipi di installazione: un'installazione rapida che crea AWS le risorse necessarie all'utente o un'installazione manuale in cui AWS le risorse vengono create dall'utente. Per ulteriori informazioni, consulta [Installare il software AWS IoT Greengrass Core](install-greengrass-core-v2.md).

Puoi anche seguire un tutorial per installare il nucleo Greengrass ed esplorare lo sviluppo dei componenti Greengrass. Per ulteriori informazioni, consulta [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md).

## Configurazione
<a name="greengrass-nucleus-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare quando si distribuisce il componente. Alcuni parametri richiedono il riavvio del software AWS IoT Greengrass Core per avere effetto. Per ulteriori informazioni sui motivi e sulle modalità di configurazione di questo componente, consulta[Configurare il software AWS IoT Greengrass Core](configure-greengrass-core-v2.md).

`iotRoleAlias`  
<a name="nucleus-component-configuration-iot-role-alias"></a>L'alias del AWS IoT ruolo che rimanda a un ruolo IAM per lo scambio di token. Il fornitore di AWS IoT credenziali assume questo ruolo per consentire al dispositivo principale Greengrass di interagire con i servizi. AWS Per ulteriori informazioni, consulta [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).  
Quando si esegue il software AWS IoT Greengrass Core con l'`--provision true`opzione, il software fornisce un alias di ruolo e ne imposta il valore nel componente nucleo.

  `interpolateComponentConfiguration`   
[(Facoltativo) È possibile abilitare il Greengrass nucleus per interpolare le [variabili di ricetta dei componenti nelle configurazioni dei componenti](component-recipe-reference.md#recipe-variables) e unire gli aggiornamenti di configurazione.](update-component-configurations.md#merge-configuration-update-recipe-variables) Si consiglia di impostare questa opzione `true` in modo che il dispositivo principale possa eseguire componenti Greengrass che utilizzano variabili di ricetta nelle loro configurazioni.  
Questa funzionalità è disponibile per la versione 2.6.0 e successive di questo componente.  
Impostazione predefinita: `false`

`networkProxy`  
(Facoltativo) Il proxy di rete da utilizzare per tutte le connessioni. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy).  
<a name="nucleus-component-parameter-restart-para"></a>Quando si implementa una modifica a questo parametro di configurazione, il software AWS IoT Greengrass Core si riavvia per rendere effettiva la modifica.
Questo oggetto contiene le seguenti informazioni:    
`noProxyAddresses`  
(Facoltativo) Un elenco separato da virgole di indirizzi IP o nomi host che sono esenti dal proxy.  
`proxy`  
Il proxy a cui connettersi. Questo oggetto contiene le seguenti informazioni:    
`url`  
L'URL del server proxy nel formato`scheme://userinfo@host:port`.  <a name="nucleus-component-configuration-proxy-url-segments"></a>
+ `scheme`— Lo schema, che deve essere `http` o`https`.
**Importante**  
<a name="https-proxy-greengrass-nucleus-requirement"></a>I dispositivi core Greengrass devono eseguire [Greengrass nucleus](#greengrass-nucleus-component) v2.5.0 o versione successiva per utilizzare i proxy HTTPS.  
Se configuri un proxy HTTPS, devi aggiungere il certificato CA del server proxy al certificato Amazon root CA del dispositivo principale. Per ulteriori informazioni, consulta [Abilita il dispositivo principale in modo che consideri attendibile un proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust).
+ `userinfo`— (Facoltativo) Le informazioni sul nome utente e sulla password. Se si specificano queste informazioni nel`url`, il dispositivo principale Greengrass ignora i `username` campi and. `password`
+ `host`— Il nome host o l'indirizzo IP del server proxy.
+ `port`— (Facoltativo) Il numero di porta. Se non specifichi la porta, il dispositivo principale Greengrass utilizza i seguenti valori predefiniti:
  + `http`— 80
  + `https`— 443  
`username`  
(Facoltativo) Il nome utente che autentica il server proxy.  
`password`  
(Facoltativo) La password che autentica il server proxy.

`mqtt`  
(Opzionale) La configurazione MQTT per il dispositivo principale Greengrass. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy).  
<a name="nucleus-component-parameter-restart-para"></a>Quando si implementa una modifica a questo parametro di configurazione, il software AWS IoT Greengrass Core si riavvia per rendere effettiva la modifica.
Questo oggetto contiene le seguenti informazioni:    
`port`  
(Facoltativo) La porta da utilizzare per le connessioni MQTT.  
Impostazione predefinita: `8883`  
`keepAliveTimeoutMs`  
(Facoltativo) La quantità di tempo in millisecondi tra ogni `PING` messaggio inviato dal client per mantenere attiva la connessione MQTT. Questo valore deve essere maggiore di. `pingTimeoutMs`  
Impostazione predefinita: `60000` (60 secondi)  
`pingTimeoutMs`  
(Facoltativo) La quantità di tempo in millisecondi che il client attende di ricevere un `PINGACK` messaggio dal server. Se l'attesa supera il timeout, il dispositivo principale si chiude e riapre la connessione MQTT. Questo valore deve essere inferiore a. `keepAliveTimeoutMs`  
Impostazione predefinita: `30000` (30 secondi)  
`operationTimeoutMs`  
(Facoltativo) La quantità di tempo in millisecondi che il client attende il completamento delle operazioni MQTT (come `CONNECT` o). `PUBLISH` Questa opzione non si applica ai messaggi `PING` MQTT o keep alive.  
Impostazione predefinita: `30000` (30 secondi)  
`maxInFlightPublishes`  
(Facoltativo) Il numero massimo di messaggi MQTT QoS 1 non riconosciuti che possono essere in transito contemporaneamente.  
Questa funzionalità è disponibile per la versione 2.1.0 e successive di questo componente.  
Impostazione predefinita: `5`  
Intervallo valido: valore massimo di 100  
`maxMessageSizeInBytes`  
(Facoltativo) La dimensione massima di un messaggio MQTT. Se un messaggio supera questa dimensione, il nucleo di Greengrass lo respinge con un errore.  
Questa funzionalità è disponibile per la versione 2.1.0 e successive di questo componente.  
Impostazione predefinita: `131072` (128 KB)  
Intervallo valido: valore massimo di `2621440` (2,5 MB)  
`maxPublishRetry`  
(Facoltativo) Il numero massimo di volte in cui riprovare un messaggio che non viene pubblicato. È possibile specificare di `-1` riprovare un numero illimitato di volte.  
Questa funzionalità è disponibile per la versione 2.1.0 e successive di questo componente.  
Impostazione predefinita: `100`  
`spooler`  
(Opzionale) La configurazione dello spooler MQTT per il dispositivo principale Greengrass. Questo oggetto contiene le seguenti informazioni:    
`storageType`  
Il tipo di archiviazione per l'archiviazione dei messaggi. Se `storageType` è impostato su`Disk`, `pluginName` può essere configurato. È possibile specificare `Memory` o `Disk`.  
[Questa funzionalità è disponibile per la versione 2.11.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Se lo spooler MQTT `storageType` è impostato su `Disk` e si desidera effettuare il downgrade di Greengrass nucleus dalla versione 2.11.x a una versione precedente, è necessario modificare nuovamente la configurazione in. `Memory` L'unica configurazione `storageType` supportata nelle versioni 2.10.x e precedenti di Greengrass nucleus è. `Memory` La mancata osservanza di queste indicazioni può causare la rottura dello spooler. Ciò impedirebbe al dispositivo principale Greengrass di inviare messaggi MQTT a. Cloud AWS
Impostazione predefinita: `Memory`  
`pluginName`  
(Facoltativo) Il nome del componente del plugin. Questo componente verrà utilizzato solo se `storageType` è impostato su`Disk`. Questa opzione è predefinita `aws.greengrass.DiskSpooler` e utilizzerà quella fornita da GreenGrass. [Spooler del disco](disk-spooler-component.md)  
[Questa funzionalità è disponibile per la versione 2.11.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `"aws.greengrass.DiskSpooler"`  
`maxSizeInBytes`  
(Facoltativo) La dimensione massima della cache in cui il dispositivo principale archivia i messaggi MQTT non elaborati in memoria. Se la cache è piena, i nuovi messaggi vengono rifiutati.  
Impostazione predefinita: `2621440` (2,5 MB)  
`keepQos0WhenOffline`  
(Facoltativo) È possibile eseguire lo spool dei messaggi MQTT QoS 0 che il dispositivo principale riceve mentre è offline. Se imposti questa opzione su`true`, il dispositivo principale sposta i messaggi QoS 0 che non può inviare mentre è offline. Se imposti questa opzione su`false`, il dispositivo principale scarta questi messaggi. Il dispositivo principale esegue sempre lo spoiler dei messaggi QoS 1 a meno che lo spool non sia pieno.  
Impostazione predefinita: `false`  
`version`  
(Facoltativo) La versione di MQTT. È possibile specificare `mqtt3` o `mqtt5`.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `mqtt5`  
`receiveMaximum`  
(Facoltativo) Il numero massimo di pacchetti QoS1 non riconosciuti che il broker può inviare.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `100`  
`sessionExpirySeconds`  
(Facoltativo) La quantità di tempo in secondi che puoi richiedere per la durata di una sessione da IoT Core. L'impostazione predefinita è il tempo massimo supportato da AWS IoT Core.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `604800 (7 days)`  
`minimumReconnectDelaySeconds`  
(Facoltativo) Un'opzione per il comportamento di riconnessione. La quantità minima di tempo in secondi per la riconnessione di MQTT.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `1`  
`maximumReconnectDelaySeconds`  
(Facoltativo) Un'opzione per il comportamento di riconnessione. La quantità massima di tempo in secondi per la riconnessione di MQTT.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `120`  
`minimumConnectedTimeBeforeRetryResetSeconds`  
(Facoltativo) Un'opzione per il comportamento di riconnessione. Il periodo di tempo in secondi in cui una connessione deve essere attiva prima che il ritardo tra i tentativi venga ripristinato al minimo.  
[Questa funzionalità è disponibile per la versione 2.10.0 e successive del componente Greengrass nucleus.](#greengrass-nucleus-component)  
Impostazione predefinita: `30`

  `jvmOptions`  
(Facoltativo) Le opzioni JVM da utilizzare per eseguire il software Core. AWS IoT Greengrass Per informazioni sulle opzioni JVM consigliate per l'esecuzione del software AWS IoT Greengrass Core, vedere. [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning)  
<a name="nucleus-component-parameter-restart-para"></a>Quando si implementa una modifica a questo parametro di configurazione, il software AWS IoT Greengrass Core si riavvia per rendere effettiva la modifica.

`iotDataEndpoint`  
<a name="nucleus-component-configuration-iot-data-endpoint"></a>L'endpoint di AWS IoT dati per il tuo. Account AWS  
<a name="nucleus-component-set-iot-endpoints"></a>Quando esegui il software AWS IoT Greengrass Core con l'`--provision true`opzione, il software ottiene i dati e le credenziali dagli endpoint AWS IoT e li imposta nel componente nucleus.

`iotCredEndpoint`  
<a name="nucleus-component-configuration-iot-cred-endpoint"></a>L'endpoint delle AWS IoT credenziali per il tuo. Account AWS  
<a name="nucleus-component-set-iot-endpoints"></a>Quando esegui il software AWS IoT Greengrass Core con l'`--provision true`opzione, il software ottiene i dati e le credenziali dagli endpoint AWS IoT e li imposta nel componente nucleus.

`greengrassDataPlaneEndpoint`  
Questa funzionalità è disponibile nella versione 2.7.0 e successive di questo componente.  
Per ulteriori informazioni, consulta [Utilizza un certificato del dispositivo firmato da una CA privata](configure-greengrass-core-v2.md#configure-nucleus-private-ca).

`greengrassDataPlanePort`  
Questa funzionalità è disponibile nella versione 2.0.4 e successive di questo componente.  
(Facoltativo) La porta da utilizzare per le connessioni sul piano dati. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy).  
È necessario specificare una porta in cui il dispositivo può effettuare connessioni in uscita. Se specifichi una porta bloccata, il dispositivo non sarà in grado di connettersi per AWS IoT Greengrass ricevere distribuzioni.
Seleziona una delle opzioni seguenti:  
+ `443`
+ `8443`
Impostazione predefinita: `8443`

`awsRegion`  
Quello da usare Regione AWS .

`runWithDefault`  
L'utente del sistema da utilizzare per eseguire i componenti.  
<a name="nucleus-component-parameter-restart-para"></a>Quando si implementa una modifica a questo parametro di configurazione, il software AWS IoT Greengrass Core si riavvia per rendere effettiva la modifica.
Questo oggetto contiene le seguenti informazioni:    
`posixUser`  
Il nome o l'ID dell'utente del sistema e, facoltativamente, del gruppo di sistema utilizzato dal dispositivo principale per eseguire componenti generici e Lambda. Specifica l'utente e il gruppo separati da due punti (`:`) nel seguente formato: `user:group`. Il gruppo è facoltativo. Se non si specifica un gruppo, il software AWS IoT Greengrass Core utilizza il gruppo principale per l'utente. Ad esempio, puoi specificare `ggc_user` o `ggc_user:ggc_group`. Per ulteriori informazioni, consulta [Configurare l'utente che esegue i componenti](configure-greengrass-core-v2.md#configure-component-user).  
Quando si esegue il programma di installazione del software AWS IoT Greengrass Core con l'`--component-default-user ggc_user:ggc_group`opzione, il software imposta questo parametro nel componente nucleus.  
`windowsUser`  
Questa funzionalità è disponibile nella versione 2.5.0 e successive di questo componente.  
Il nome dell'utente Windows da utilizzare per eseguire questo componente sui dispositivi Windows principali. L'utente deve esistere su ogni dispositivo Windows principale e il nome e la password devono essere memorizzati nell'istanza di Credentials Manager dell' LocalSystem account. Per ulteriori informazioni, consulta [Configurare l'utente che esegue i componenti](configure-greengrass-core-v2.md#configure-component-user).  
Quando si esegue il programma di installazione del software AWS IoT Greengrass Core con l'`--component-default-user ggc_user`opzione, il software imposta questo parametro nel componente nucleus.  
`systemResourceLimits`  
Questa funzionalità è disponibile nella versione 2.4.0 e successive di questo componente. AWS IoT Greengrass attualmente non supporta questa funzionalità sui dispositivi Windows core.   
I limiti delle risorse di sistema da applicare ai processi dei componenti Lambda generici e non containerizzati per impostazione predefinita. È possibile ignorare i limiti delle risorse di sistema per i singoli componenti quando si crea una distribuzione. Per ulteriori informazioni, consulta [Configura i limiti delle risorse di sistema per i componenti](configure-greengrass-core-v2.md#configure-component-system-resource-limits).  
Questo oggetto contiene le seguenti informazioni:    
`cpus`  
 <a name="system-resource-limits-cpu-definition-each"></a>La quantità massima di tempo di CPU che i processi di ciascun componente possono utilizzare sul dispositivo principale. Il tempo totale della CPU di un dispositivo principale è equivalente al numero di core CPU del dispositivo. Ad esempio, su un dispositivo principale con 4 core CPU, puoi impostare questo valore in modo da `2` limitare i processi di ciascun componente al 50% di utilizzo di ciascun core della CPU. Su un dispositivo con 1 core di CPU, puoi impostare questo valore su `0.25` per limitare i processi di ciascun componente al 25 percento di utilizzo della CPU. Se imposti questo valore su un numero maggiore del numero di core della CPU, il software AWS IoT Greengrass Core non limita l'utilizzo della CPU da parte dei componenti.   
`memory`  
 <a name="system-resource-limits-memory-definition-each"></a>La quantità massima di RAM (in kilobyte) che i processi di ciascun componente possono utilizzare sul dispositivo principale. 

 `s3EndpointType`   
(Facoltativo) Il tipo di endpoint S3. Questo parametro avrà effetto solo per la regione Stati Uniti orientali (Virginia settentrionale) (`us-east-1`). L'impostazione di questo parametro da qualsiasi altra regione verrà ignorata. Seleziona una delle opzioni seguenti:  
+ `REGIONAL`— Il client S3 e l'URL predefinito utilizzano l'endpoint regionale.
+ `GLOBAL`— Il client S3 e l'URL predefinito utilizzano l'endpoint legacy.
+ `DUALSTACK`— L'URL predefinito S3 utilizza l'endpoint dualstack.
Impostazione predefinita: `GLOBAL`

 `fipsMode`   
(Facoltativo) Fa sì che Greengrass utilizzi gli endpoint FIPS. [Per ulteriori informazioni su come abilitare gli endpoint FIPS, consulta Endpoint FIPS.](FIPS.html)  
Seleziona una delle opzioni seguenti:  
+ `true`Se impostato su true, gli endpoint utilizzeranno l'endpoint FIPS.
+ `false`Se false, gli endpoint non utilizzeranno l'endpoint FIPS.
Impostazione predefinita: `false`

`logging`  
(Facoltativo) La configurazione di registrazione per il dispositivo principale. Per ulteriori informazioni su come configurare e utilizzare i log di Greengrass, vedere. [Monitora AWS IoT Greengrass i registri](monitor-logs.md)  
Questo oggetto contiene le seguenti informazioni:    
  `level`   
(Facoltativo) Il livello minimo di messaggi di registro da emettere.  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
  `format`   
(Facoltativo) Il formato dei dati dei log. Seleziona una delle opzioni seguenti:  
+ `TEXT`— Scegliete questa opzione se desiderate visualizzare i log sotto forma di testo.
+ `JSON`— Scegliete questa opzione se desiderate visualizzare i log con il comando [Greengrass CLI logs o interagire con i](gg-cli-logs.md) log a livello di codice.
Impostazione predefinita: `TEXT`  
`outputType`  
(Facoltativo) Il tipo di output per i log. Seleziona una delle opzioni seguenti:  
+ `FILE`— Il software AWS IoT Greengrass Core invia i log nei file nella directory specificata. `outputDirectory`
+ `CONSOLE`— Il software AWS IoT Greengrass Core stampa i registri su. `stdout` Scegliete questa opzione per visualizzare i registri man mano che il dispositivo principale li stampa.
Impostazione predefinita: `FILE`  
  `fileSizeKB`   
(Facoltativo) La dimensione massima di ogni file di registro (in kilobyte). Dopo che un file di registro supera questa dimensione massima, il software AWS IoT Greengrass Core crea un nuovo file di registro.  
<a name="nucleus-component-logging-parameter-file-only"></a>Questo parametro si applica solo quando si specifica `FILE` per`outputType`.  
Impostazione predefinita: `1024`  
  `totalLogsSizeKB`   
(Facoltativo) La dimensione totale massima dei file di registro (in kilobyte) per ogni componente, incluso il nucleo Greengrass. [I file di registro del nucleo di Greengrass includono anche i log dei componenti del plugin.](develop-greengrass-components.md#component-types) Dopo che la dimensione totale dei file di registro di un componente supera questa dimensione massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi del componente.  
Questo parametro è equivalente al parametro [limite di spazio su disco](log-manager-component.md#log-manager-component-configuration) (`diskSpaceLimit`) [del componente di gestione dei registri](log-manager-component.md), che è possibile specificare per il nucleo di Greengrass (sistema) e ogni componente. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per il nucleo Greengrass e ciascun componente.  
<a name="nucleus-component-logging-parameter-file-only"></a>Questo parametro si applica solo quando si specifica `FILE` per. `outputType`  
Impostazione predefinita: `10240`  
  `outputDirectory`   
(Facoltativo) La directory di output per i file di registro.  
<a name="nucleus-component-logging-parameter-file-only"></a>Questo parametro si applica solo quando si specifica `FILE` per`outputType`.  
Impostazione predefinita:`/greengrass/v2/logs`, `/greengrass/v2` dov'è la cartella AWS IoT Greengrass principale.

  `fleetstatus`   
Questo parametro è disponibile nella versione 2.1.0 e successive di questo componente.  
(Facoltativo) La configurazione dello stato del parco macchine per il dispositivo principale.  
Questo oggetto contiene le seguenti informazioni:    
`periodicStatusPublishIntervalSeconds`  
(Facoltativo) Il periodo di tempo (in secondi) tra il quale il dispositivo principale pubblica lo stato del dispositivo su. Cloud AWS  
Minimo: `86400` (24 ore)  
Impostazione predefinita: `86400` (24 ore)

  `telemetry`   
(Facoltativo) La configurazione della telemetria sanitaria del sistema per il dispositivo principale. Per ulteriori informazioni sulle metriche di telemetria e su come agire sui dati di telemetria, consulta. [Raccogli dati di telemetria sanitaria del sistema dai dispositivi principali AWS IoT Greengrass](telemetry.md)  
Questo oggetto contiene le seguenti informazioni:    
`enabled`  
(Facoltativo) È possibile abilitare o disabilitare la telemetria.  
Impostazione predefinita: `true`  
`periodicAggregateMetricsIntervalSeconds`  
(Facoltativo) L'intervallo (in secondi) durante il quale il dispositivo principale aggrega le metriche.  
Se impostate questo valore su un valore inferiore al valore minimo supportato, il nucleo utilizza invece il valore predefinito.  
Minimo: `3600`  
Impostazione predefinita: `3600`  
`periodicPublishMetricsIntervalSeconds`  
(Facoltativo) Il periodo di tempo (in secondi) tra il quale il dispositivo principale pubblica le metriche di telemetria su. Cloud AWS  
Se impostate questo valore su un valore inferiore al valore minimo supportato, il nucleo utilizza invece il valore predefinito.  
Minimo: `86400`  
Impostazione predefinita: `86400`

`deploymentPollingFrequencySeconds`  
(Facoltativo) Il periodo in secondi in cui eseguire il sondaggio per le notifiche di distribuzione.  
Impostazione predefinita: `15`

`componentStoreMaxSizeBytes`  
(Facoltativo) La dimensione massima su disco dell'archivio componenti, che comprende le ricette e gli artefatti dei componenti.  
Impostazione predefinita: `10000000000` (10 GB)

  `platformOverride`   
(Facoltativo) Un dizionario di attributi che identifica la piattaforma del dispositivo principale. Utilizzatelo per definire gli attributi personalizzati della piattaforma che le ricette dei componenti possono utilizzare per identificare il ciclo di vita e gli artefatti corretti per il componente. Ad esempio, è possibile definire un attributo di capacità hardware per distribuire solo il set minimo di artefatti per l'esecuzione di un componente. Per ulteriori informazioni, vedete il [parametro manifest platform nella ricetta](component-recipe-reference.md#component-platform-definition) del componente.  
È inoltre possibile utilizzare questo parametro per sovrascrivere gli attributi `os` e di `architecture` piattaforma del dispositivo principale.

  `httpClient`   
Questo parametro è disponibile nella versione 2.5.0 e successive di questo componente.  
(Facoltativo) La configurazione del client HTTP per il dispositivo principale. Queste opzioni di configurazione si applicano a tutte le richieste HTTP effettuate da questo componente. Se un dispositivo principale funziona su una rete più lenta, puoi aumentare queste durate di timeout per evitare il timeout delle richieste HTTP.  
Questo oggetto contiene le seguenti informazioni:    
`connectionTimeoutMs`  
(Facoltativo) La quantità di tempo (in millisecondi) di attesa dell'apertura di una connessione prima del timeout della richiesta di connessione.  
Impostazione predefinita: `2000` (2 secondi)  
`socketTimeoutMs`  
(Facoltativo) La quantità di tempo (in millisecondi) di attesa per il trasferimento dei dati su una connessione aperta prima del timeout della connessione.  
Impostazione predefinita: `30000` (30 secondi)

  `deploymentConfigurationTimeSource`   
Questo parametro è disponibile nella versione 2.15.0 e successive di questo componente.  
(Facoltativo) Il timestamp da utilizzare durante l'elaborazione di una distribuzione. L'impostazione predefinita è. `deploymentCreationTime`  
Questo oggetto contiene i seguenti valori:    
`deploymentCreationTime`  
Il valore predefinito di`deploymentConfigurationTimeSource`. Il dispositivo utilizza il timestamp di creazione della distribuzione per risolvere i conflitti delle chiavi di configurazione durante l'elaborazione. Quando questo comportamento è selezionato, la configurazione locale del dispositivo gestita dal nucleo può avere un timestamp maggiore di quello della distribuzione in entrata e rifiutare le modifiche di configurazione in entrata che ora sono considerate obsolete.  
`deploymentProcessingTime`  
Il dispositivo utilizza il timestamp locale per risolvere i conflitti tra le chiavi di configurazione durante l'elaborazione della distribuzione. Una volta elaborato, il dispositivo aggiorna le configurazioni in base al timestamp di elaborazione anziché al timestamp di creazione della distribuzione. Questo comportamento presuppone che l'orologio del dispositivo sia calibrato correttamente.  
Configura questa impostazione del nucleo nell'immagine o nell'installazione iniziale del dispositivo anziché tramite una distribuzione quando desideri che i nuovi dispositivi utilizzino questo comportamento alla prima connessione. Usa l'[https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html)opzione del programma di installazione classico di nucleus per questa configurazione.  
Questa configurazione iniziale è essenziale perché i dispositivi elaborano più distribuzioni in ordine arbitrario. Senza una corretta configurazione iniziale, un dispositivo potrebbe elaborare le distribuzioni utilizzando il `deploymentCreationTime` comportamento predefinito prima di ricevere la distribuzione su cui è impostata la configurazione del nucleo. `deploymentProcessingTime`

**Example Esempio: fusione e aggiornamento della configurazione**  

```
{
  "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias",
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "http://my-proxy-server:1100",
      "username": "Mary_Major",
      "password": "pass@word1357"
    }
  },
  "mqtt": {
    "port": 443
  },
  "greengrassDataPlanePort": 443,
  "jvmOptions": "-Xmx64m",
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}
```

## File di registro locale
<a name="greengrass-nucleus-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="greengrass-nucleus-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.16.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.16.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.15.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.14.3  |  Correzioni di bug e miglioramenti [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.14.2  |  Correzioni di bug e miglioramenti [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.14.1  |  Correzioni di bug e miglioramenti [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.14.0  |  Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.13.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.3  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  Correzioni di bug e miglioramenti [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.12.0  |  <a name="changelog-nucleus-2.12.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.11.3  |  <a name="changelog-nucleus-2.11.3"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.11.2  |  <a name="changelog-nucleus-2.11.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.11.1  |  <a name="changelog-nucleus-2.11.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.11.0  |  <a name="changelog-nucleus-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.10.3  |  <a name="changelog-nucleus-2.10.3"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.10.2  |  <a name="changelog-nucleus-2.10.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.10.1  |  <a name="changelog-nucleus-2.10.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.10.0  |  <a name="changelog-nucleus-2.10.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.6  |  <a name="changelog-nucleus-2.9.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.5  |  <a name="changelog-nucleus-2.9.5"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.4  |  <a name="changelog-nucleus-2.9.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.3  |  <a name="changelog-nucleus-2.9.3"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.2  |  <a name="changelog-nucleus-2.9.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.1  |  <a name="changelog-nucleus-2.9.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.9.0  |  <a name="changelog-nucleus-2.9.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.8.1  |  <a name="changelog-nucleus-2.8.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.8.0  |  <a name="changelog-nucleus-2.8.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.7.0  |  <a name="changelog-nucleus-2.7.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.6.0  |  <a name="changelog-nucleus-2.6.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.6  |  <a name="changelog-nucleus-2.5.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.5  |  <a name="changelog-nucleus-2.5.5"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.4  |  <a name="changelog-nucleus-2.5.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.3  |  <a name="changelog-nucleus-2.5.3"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.2  |  <a name="changelog-nucleus-2.5.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.1  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  <a name="changelog-nucleus-2.5.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.5.0  |  <a name="changelog-nucleus-2.5.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.4.0  |  <a name="changelog-nucleus-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.3.0  |  <a name="changelog-nucleus-2.3.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.2.0  |  <a name="changelog-nucleus-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.1.0  |  <a name="changelog-nucleus-2.1.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.0.5  |  <a name="changelog-nucleus-2.0.5"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.0.4  |  <a name="changelog-nucleus-2.0.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-component.html)  | 
|  2.0.3  |  Versione iniziale.  | 

# Greengrass Nucleus Lite
<a name="greengrass-nucleus-lite-component"></a>

Greengrass nucleus lite (`aws.greengrass.NucleusLite`) è un runtime per dispositivi edge vincolati ottimizzato per un ingombro di memoria minimo (utilizza meno di 5 MB di RAM). È stato introdotto con la AWS IoT Greengrass versione 2.14.0 ed è retrocompatibile con componenti AWS IoT Greengrass generici, API Greengrass V2 e SDK.

Il Greengrass nucleus lite è offerto come alternativa al comune [Greengrass nucleus (`aws.greengrass.Nucleus`)](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html) e può essere utilizzato in flotte eterogenee di dispositivi Greengrass.

**Topics**
+ [Versioni](#greengrass-nucleus-lite-component-versions)
+ [Sistema operativo](#greengrass-nucleus-lite-component-os-support)
+ [Requisiti](#greengrass-nucleus-lite-component-requirements)
+ [Compatibilità](#greengrass-nucleus-lite-component-compatibility)
+ [Download e installazione](#greengrass-nucleus-lite-component-install)
+ [Configurazione](#greengrass-nucleus-lite-component-configuration)
+ [File di registro locale](#greengrass-nucleus-lite-component-log-file)
+ [Changelog](#greengrass-nucleus-lite-component-changelog)

## Versioni
<a name="greengrass-nucleus-lite-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Sistema operativo
<a name="greengrass-nucleus-lite-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux (distribuzioni con systemd)

Per ulteriori informazioni, vedere [Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html) nucleus.

## Requisiti
<a name="greengrass-nucleus-lite-component-requirements"></a>

I dispositivi devono soddisfare determinati requisiti per installare ed eseguire il AWS IoT Greengrass nucleus lite e il AWS IoT Greengrass software Core. Per ulteriori informazioni, consulta la [guida all'installazione](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#setting-up-greengrass-nucleus-lite).
+ 5 MB di spazio RAM per il runtime Nucleus.
+ 5 MB di spazio di archiviazione (disco/flash).

[Le dipendenze aggiuntive del sistema sono documentate nella Guida all'installazione.](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#dependencies)

Il componente Greengrass nucleus è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue:
+ Il nucleo Greengrass deve disporre di connettività ai AWS IoT dati, alle AWS IoT credenziali e ad Amazon S3.

## Compatibilità
<a name="greengrass-nucleus-lite-component-compatibility"></a>

Il AWS IoT Greengrass nucleus lite è compatibile con l'API AWS IoT Greengrass v2 (sottoinsieme di) ed è supportato. SDKs Non dipende da alcun linguaggio specifico, runtimes/VMs ma i componenti aggiunti a una distribuzione possono richiedere la presenza di runtime specifici (ad esempio: Java JVM, Python). Per ulteriori informazioni sulle funzionalità supportate da Greengrass nucleus lite, vedere. [Compatibilità delle funzionalità Greengrass](operating-system-feature-support-matrix.md)

## Download e installazione
<a name="greengrass-nucleus-lite-component-install"></a>

Puoi scaricare un pacchetto apt, [compilare dai sorgenti](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/README.md#getting-started), [usare un layer Yocto](https://github.com/aws4embeddedlinux/meta-aws) o [scaricare un'immagine Yocto precompilata per dispositivi compatibili (ad es.](https://github.com/aws4embeddedlinux/meta-aws-demos)). RaspberryPi Dalla [AWS IoT Core Console](https://console.aws.amazon.com/iot/home) potrai scaricare un **kit di connessione** contenente tutte le credenziali e la configurazione iniziale per il tuo dispositivo. Le istruzioni per l'installazione sono incluse in ogni metodo di distribuzione specifico.

Puoi anche seguire un tutorial per installare AWS IoT Greengrass nucleus lite ed esplorare lo sviluppo dei componenti Greengrass. Per ulteriori informazioni, consulta [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md).

## Configurazione
<a name="greengrass-nucleus-lite-component-configuration"></a>

[Il nucleo fornisce i seguenti parametri di configurazione.](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#configuring-greengrass) Alcuni parametri richiedono il riavvio del software AWS IoT Greengrass Core per avere effetto.

`iotRoleAlias`  
L'alias del AWS IoT ruolo che rimanda a un ruolo IAM per lo scambio di token. Il fornitore di AWS IoT credenziali assume questo ruolo per consentire al dispositivo principale Greengrass di interagire con i servizi. AWS Per ulteriori informazioni, consulta [Autorizzare i dispositivi principali a](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) interagire con i servizi. AWS 

`iotDataEndpoint`  
<a name="nucleus-component-configuration-iot-data-endpoint"></a>L'endpoint di AWS IoT dati per il tuo. Account AWS

`iotCredEndpoint`  
<a name="nucleus-component-configuration-iot-cred-endpoint"></a>L'endpoint di AWS IoT credenziali per il tuo. Account AWS

`greengrassDataPlanePort`  
La porta da utilizzare per le connessioni sul piano dati. Per ulteriori informazioni, consulta [Connect sulla porta 443 o tramite un proxy di rete](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy).  
È necessario specificare una porta in cui il dispositivo può effettuare connessioni in uscita. Se specifichi una porta bloccata, il dispositivo non sarà in grado di connettersi per AWS IoT Greengrass ricevere distribuzioni. Seleziona una delle opzioni seguenti:  
+ `443`
+ `8443`
+ Impostazione predefinita: `8443`

`awsRegion`  
Quello da usare Regione AWS .

`runWithDefault`  
L'utente del sistema da utilizzare per eseguire i componenti.  
<a name="nucleus-component-parameter-restart-para"></a>Quando si implementa una modifica a questo parametro di configurazione, il software AWS IoT Greengrass Core si riavvia per rendere effettiva la modifica.
Questo oggetto contiene le seguenti informazioni:    
`posixUser`  
Il nome o l'ID dell'utente di sistema e, facoltativamente, del gruppo di sistema utilizzati dal dispositivo principale per eseguire componenti generici. Specifica l'utente e il gruppo separati da due punti (`:`) nel seguente formato: `user:group`. Il gruppo è facoltativo. Se non si specifica un gruppo, il software AWS IoT Greengrass Core utilizza il gruppo primario per l'utente. Ad esempio, puoi specificare `ggc_user` o `ggc_user:ggc_group`. Per ulteriori informazioni, consulta [Configurare l'utente che esegue i componenti](configure-greengrass-core-v2.md#configure-component-user).

`networkProxy`  
(Facoltativo) Il proxy di rete da utilizzare per tutte le connessioni. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy).  
Quando si distribuisce una modifica a questo parametro di configurazione, la modifica avrà effetto dopo il successivo riavvio del software AWS IoT Greengrass Core.
Questo oggetto contiene le seguenti informazioni:    
`noProxyAddresses`  
(Facoltativo) Un elenco separato da virgole di indirizzi IP o nomi host che sono esenti dal proxy.  
`proxy`  
Il proxy a cui connettersi. Questo oggetto contiene le seguenti informazioni:    
`url`  
L'URL del server proxy nel formato`http://host:port`.  
+ `scheme`— Lo schema, che deve essere`http`.
+ `host`— Il nome host o l'indirizzo IP del server proxy.
+ `port`— (Facoltativo) Il numero di porta. Se non specifichi la porta, il dispositivo principale Greengrass utilizza il seguente valore predefinito:
  + `http`— 80

## File di registro locale
<a name="greengrass-nucleus-lite-component-log-file"></a>

I messaggi vengono registrati su stdout e i file di registro vengono gestiti da systemd.

**Per visualizzare i log di questo componente**
+ Usa `journalctl` per visualizzare i log.

## Changelog
<a name="greengrass-nucleus-lite-component-changelog"></a>


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.3.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
|  2.0.0  |  Versione iniziale.  | 

# Autenticazione del dispositivo client
<a name="client-device-auth-component"></a>

Il componente di autenticazione del dispositivo client (`aws.greengrass.clientdevices.Auth`) autentica i dispositivi client e autorizza le azioni dei dispositivi client.

**Nota**  <a name="client-device-component-context"></a>
I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta [Interagisci con dispositivi IoT locali](interact-with-local-iot-devices.md).

**Topics**
+ [Versioni](#client-device-auth-component-versions)
+ [Tipo](#client-device-auth-component-type)
+ [Sistema operativo](#client-device-auth-component-os-support)
+ [Requisiti](#client-device-auth-component-requirements)
+ [Dipendenze](#client-device-auth-component-dependencies)
+ [Configurazione](#client-device-auth-component-configuration)
+ [File di registro locale](#client-device-auth-component-log-file)
+ [Changelog](#client-device-auth-component-changelog)

## Versioni
<a name="client-device-auth-component-versions"></a>

**Nota**  
La versione 2.3.0 di autenticazione dei dispositivi client è stata interrotta. Si consiglia vivamente di eseguire l'aggiornamento alla versione 2.3.1 o successiva di autenticazione del dispositivo client.

Questo componente ha le seguenti versioni:
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="client-device-auth-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="client-device-auth-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="client-device-auth-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il [ruolo del servizio Greengrass](greengrass-service-role.md) deve essere associato all'utente Account AWS e consentire l'`iot:DescribeCertificate`autorizzazione.
+ La AWS IoT politica del dispositivo principale deve consentire le seguenti autorizzazioni:
  + `greengrass:GetConnectivityInfo`, dove le risorse includono l'ARN del dispositivo principale che esegue questo componente
  + `greengrass:VerifyClientDeviceIoTCertificateAssociation`, dove le risorse includono l'Amazon Resource Name (ARN) di ogni dispositivo client che si connette al dispositivo principale
  + `greengrass:VerifyClientDeviceIdentity`
  + `greengrass:PutCertificateAuthorities`
  + `iot:Publish`, dove le risorse includono l'ARN del seguente argomento MQTT:
    + `$aws/things/coreDeviceThingName*-gci/shadow/get`
  + `iot:Subscribe`, dove le risorse includono i seguenti filtri ARNs tematici MQTT:
    + `$aws/things/coreDeviceThingName*-gci/shadow/update/delta`
    + `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted`
  + `iot:Receive`, dove le risorse includono i seguenti ARNs argomenti MQTT:
    + `$aws/things/coreDeviceThingName*-gci/shadow/update/delta`
    + `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted`

  Per ulteriori informazioni, consultare [AWS IoT politiche per le operazioni sul piano dati](device-auth.md#iot-policies) e [AWS IoT Politica minima per il supporto dei dispositivi client](device-auth.md#client-device-support-minimal-iot-policy).
+ (Facoltativo) Per utilizzare l'autenticazione offline, il ruolo AWS Identity and Access Management (IAM) utilizzato dal AWS IoT Greengrass servizio deve contenere le seguenti autorizzazioni:
  + `greengrass:ListClientDevicesAssociatedWithCoreDevice`per consentire al dispositivo principale di elencare i client per l'autenticazione offline.
+ Il componente di autenticazione del dispositivo client è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente di autenticazione del dispositivo client deve avere connettività a AWS IoT data, AWS IoT Credentials e Amazon S3.

### Endpoint e porte
<a name="client-device-auth-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `iot.region.amazonaws.com`  | 443 | Sì |  Utilizzato per ottenere informazioni sui AWS IoT certificati Thing.  | 

## Dipendenze
<a name="client-device-auth-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#client-device-auth-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.5.5 ]

La tabella seguente elenca le dipendenze per la versione 2.5.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.17.0 | Flessibili | 

------
#### [ 2.5.4 ]

La tabella seguente elenca le dipendenze per la versione 2.5.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.16.0 | Flessibili | 

------
#### [ 2.5.2 – 2.5.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.5.2 e 2.5.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.15.0 | Flessibili | 

------
#### [ 2.5.1 ]

La tabella seguente elenca le dipendenze per la versione 2.5.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.14.0 | Flessibili | 

------
#### [ 2.4.4 - 2.5.0 ]

La tabella seguente elenca le dipendenze per la versione 2.4.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.13.0 | Flessibili | 

------
#### [ 2.4.3 ]

La tabella seguente elenca le dipendenze per la versione 2.4.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.12.0 | Flessibili | 

------
#### [ 2.4.1 and 2.4.2 ]

La tabella seguente elenca le dipendenze per le versioni 2.4.1 e 2.4.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.11.0 | Flessibili | 

------
#### [ 2.3.0 – 2.4.0 ]

La tabella seguente elenca le dipendenze per le versioni da 2.3.0 a 2.4.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Flessibili | 

------
#### [ 2.3.0 ]

La tabella seguente elenca le dipendenze per la versione 2.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Flessibili | 

------
#### [ 2.2.3 ]

La tabella seguente elenca le dipendenze per la versione 2.2.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <=2.9.0 | Flessibili | 

------
#### [ 2.2.2 ]

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <=2.8.0 | Flessibili | 

------
#### [ 2.2.1 ]

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.8.0 | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Flessibili | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Flessibili | 

------
#### [ 2.0.2 and 2.0.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.2 e 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Flessibili | 

------
#### [ 2.0.1 ]

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Flessibili | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="client-device-auth-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  
L'autorizzazione di sottoscrizione viene valutata durante una richiesta di sottoscrizione del client al broker MQTT locale. Se l'autorizzazione di iscrizione esistente del cliente viene revocata, il cliente non sarà più in grado di iscriversi a un argomento. Tuttavia, continuerà a ricevere messaggi da qualsiasi argomento sottoscritto in precedenza. Per evitare questo comportamento, è necessario riavviare il broker MQTT locale dopo aver revocato l'autorizzazione di sottoscrizione per forzare la riautorizzazione dei client.  
Per il componente broker MQTT 5 (EMQX), aggiornate la configurazione per riavviare il broker MQTT 5. `restartIdentifier`  
Per impostazione predefinita, il componente broker MQTT 3.1.1 (Moquette) si riavvia settimanalmente quando il certificato del server cambia costringendo i client a riautorizzare. È possibile forzare il riavvio modificando le informazioni di connettività (indirizzi IP) del dispositivo principale o effettuando una distribuzione per rimuovere il componente broker e quindi ridistribuirlo in un secondo momento.

------
#### [ v2.5.0 – 2.5.4 ]

`deviceGroups`  
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly all'inizio e alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano o finiscono con la stringa specificata. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi terminano con`MyClientDevice`.  

```
thingName: *MyClientDevice
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly in qualsiasi punto all'interno della variabile di risorsa per consentire l'accesso a tutte le risorse. Ad esempio, potete specificare **mqtt:topic:my\$1** di consentire l'accesso alle risorse che corrispondono a quell'input.  
È supportata la seguente variabile di risorsa:  
+ `mqtt:topic:${iot:Connection.Thing.ThingName}`

  Viene risolto nel nome dell'elemento nel AWS IoT Core registro per il quale viene valutata la politica. AWS IoT Core utilizza il certificato che il dispositivo presenta al momento dell'autenticazione per determinare quale elemento utilizzare per verificare la connessione. Questa variabile di policy è disponibile solo quando un dispositivo si connette tramite MQTT o MQTT tramite il protocollo. WebSocket   
`statementDescription`  
(Facoltativo) Una descrizione di questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core, senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

`certificateAuthority`  
(Facoltativo) Opzioni di configurazione dell'autorità di certificazione per sostituire l'autorità intermedia del dispositivo principale con la propria autorità di certificazione intermedia.  
Se configuri il tuo dispositivo principale Greengrass con un'autorità di certificazione (CA) personalizzata e utilizzi la stessa CA per emettere certificati per dispositivi client, Greengrass aggira i controlli delle politiche di autorizzazione per le operazioni MQTT dei dispositivi client. Il componente di autenticazione del dispositivo client si fida completamente dei client che utilizzano i certificati firmati dalla CA per cui è configurato.  
Per limitare questo comportamento quando si utilizza una CA personalizzata, crea e firma i dispositivi client utilizzando una CA o una CA intermedia diversa, quindi modifica i `certificateChainUri` campi `certificateUri` e in modo che puntino alla CA intermedia corretta.
 Questo oggetto contiene le seguenti informazioni.    
URI del certificato  
La posizione del certificato. Può essere un URI del file system o un URI che punta a un certificato archiviato in un modulo di sicurezza hardware.  
`certificateChainUri`  
La posizione della catena di certificati per la CA del dispositivo principale. Questa dovrebbe essere la catena completa di certificati fino alla CA principale. Può essere un URI del file system o un URI che punta a una catena di certificati archiviata in un modulo di sicurezza hardware.  
`privateKeyUri`  
La posizione della chiave privata del dispositivo principale. Può essere un URI del file system o un URI che punta a una chiave privata del certificato memorizzata in un modulo di sicurezza hardware.

`security`  
(Facoltativo) Opzioni di configurazione della sicurezza per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni.    
`clientDeviceTrustDurationMinutes`  
Durata in minuti entro la quale è possibile considerare attendibili le informazioni di autenticazione di un dispositivo client prima che sia necessario riautenticarsi con il dispositivo principale. Il valore predefinito è 1.

`metrics`  
(Facoltativo) Le opzioni di metrica per questo dispositivo principale. Le metriche degli errori verranno visualizzate solo in caso di errore nell'autenticazione del dispositivo client. Questo oggetto contiene le seguenti informazioni:    
`disableMetrics`  
Se il `disableMetrics` campo è impostato su`true`, l'autenticazione del dispositivo client non raccoglierà le metriche.  
Impostazione predefinita: `false`  
`aggregatePeriodSeconds`  
Il periodo di aggregazione in secondi che determina la frequenza con cui l'autenticazione del dispositivo client aggrega le metriche e le invia all'agente di telemetria. Ciò non modifica la frequenza con cui le metriche vengono pubblicate, poiché l'agente di telemetria le pubblica ancora una volta al giorno.  
Impostazione predefinita: `3600`

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia `ERRORED` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento di fusione della configurazione (utilizzando una politica relativa ai nomi degli oggetti)**  <a name="client-device-auth-component-configuration-example-mythingname"></a>
La configurazione di esempio seguente consente ai dispositivi client di pubblicare su argomenti che iniziano con il nome dell'oggetto del dispositivo client e terminano con la stringa`topic`.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "myThing": {
        "selectionRule": "thingName: *",
        "policyName": "MyThingNamePolicy"
      }
    },
    "policies": {
      "MyThingNamePolicy": {
        "policyStatement": {
          "statementDescription": "mqtt publish",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:${iot:Connection.Thing.ThingName}/*/topic"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.4.5 ]

`deviceGroups`  
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly all'inizio e alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano o finiscono con la stringa specificata. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi terminano con`MyClientDevice`.  

```
thingName: *MyClientDevice
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core, senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

`certificateAuthority`  
(Facoltativo) Opzioni di configurazione dell'autorità di certificazione per sostituire l'autorità intermedia del dispositivo principale con la propria autorità di certificazione intermedia.  
Se configuri il tuo dispositivo principale Greengrass con un'autorità di certificazione (CA) personalizzata e utilizzi la stessa CA per emettere certificati per dispositivi client, Greengrass aggira i controlli delle politiche di autorizzazione per le operazioni MQTT dei dispositivi client. Il componente di autenticazione del dispositivo client si fida completamente dei client che utilizzano i certificati firmati dalla CA per cui è configurato.  
Per limitare questo comportamento quando si utilizza una CA personalizzata, crea e firma i dispositivi client utilizzando una CA o una CA intermedia diversa, quindi modifica i `certificateChainUri` campi `certificateUri` e in modo che puntino alla CA intermedia corretta.
 Questo oggetto contiene le seguenti informazioni.    
URI del certificato  
La posizione del certificato. Può essere un URI del file system o un URI che punta a un certificato archiviato in un modulo di sicurezza hardware.  
`certificateChainUri`  
La posizione della catena di certificati per la CA del dispositivo principale. Questa dovrebbe essere la catena completa di certificati fino alla CA principale. Può essere un URI del file system o un URI che punta a una catena di certificati archiviata in un modulo di sicurezza hardware.  
`privateKeyUri`  
La posizione della chiave privata del dispositivo principale. Può essere un URI del file system o un URI che punta a una chiave privata del certificato memorizzata in un modulo di sicurezza hardware.

`security`  
(Facoltativo) Opzioni di configurazione della sicurezza per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni.    
`clientDeviceTrustDurationMinutes`  
Durata in minuti entro la quale è possibile considerare attendibili le informazioni di autenticazione di un dispositivo client prima che sia necessario riautenticarsi con il dispositivo principale. Il valore predefinito è 1.

`metrics`  
(Facoltativo) Le opzioni di metrica per questo dispositivo principale. Le metriche degli errori verranno visualizzate solo in caso di errore nell'autenticazione del dispositivo client. Questo oggetto contiene le seguenti informazioni:    
`disableMetrics`  
Se il `disableMetrics` campo è impostato su`true`, l'autenticazione del dispositivo client non raccoglierà le metriche.  
Impostazione predefinita: `false`  
`aggregatePeriodSeconds`  
Il periodo di aggregazione in secondi che determina la frequenza con cui l'autenticazione del dispositivo client aggrega le metriche e le invia all'agente di telemetria. Ciò non modifica la frequenza con cui le metriche vengono pubblicate, poiché l'agente di telemetria le pubblica ancora una volta al giorno.  
Impostazione predefinita: `3600`

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia `ERRORED` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.4.2 - v2.4.4 ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core, senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

`certificateAuthority`  
(Facoltativo) Opzioni di configurazione dell'autorità di certificazione per sostituire l'autorità intermedia del dispositivo principale con la propria autorità di certificazione intermedia.  
Se configuri il tuo dispositivo principale Greengrass con un'autorità di certificazione (CA) personalizzata e utilizzi la stessa CA per emettere certificati per dispositivi client, Greengrass aggira i controlli delle politiche di autorizzazione per le operazioni MQTT dei dispositivi client. Il componente di autenticazione del dispositivo client si fida completamente dei client che utilizzano i certificati firmati dalla CA per cui è configurato.  
Per limitare questo comportamento quando si utilizza una CA personalizzata, crea e firma i dispositivi client utilizzando una CA o una CA intermedia diversa, quindi modifica i `certificateChainUri` campi `certificateUri` e in modo che puntino alla CA intermedia corretta.
 Questo oggetto contiene le seguenti informazioni.    
URI del certificato  
La posizione del certificato. Può essere un URI del file system o un URI che punta a un certificato archiviato in un modulo di sicurezza hardware.  
`certificateChainUri`  
La posizione della catena di certificati per la CA del dispositivo principale. Questa dovrebbe essere la catena completa di certificati fino alla CA principale. Può essere un URI del file system o un URI che punta a una catena di certificati archiviata in un modulo di sicurezza hardware.  
`privateKeyUri`  
La posizione della chiave privata del dispositivo principale. Può essere un URI del file system o un URI che punta a una chiave privata del certificato memorizzata in un modulo di sicurezza hardware.

`security`  
(Facoltativo) Opzioni di configurazione della sicurezza per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni.    
`clientDeviceTrustDurationMinutes`  
Durata in minuti entro la quale è possibile considerare attendibili le informazioni di autenticazione di un dispositivo client prima che sia necessario riautenticarsi con il dispositivo principale. Il valore predefinito è 1.

`metrics`  
(Facoltativo) Le opzioni di metrica per questo dispositivo principale. Le metriche degli errori verranno visualizzate solo in caso di errore nell'autenticazione del dispositivo client. Questo oggetto contiene le seguenti informazioni:    
`disableMetrics`  
Se il `disableMetrics` campo è impostato su`true`, l'autenticazione del dispositivo client non raccoglierà le metriche.  
Impostazione predefinita: `false`  
`aggregatePeriodSeconds`  
Il periodo di aggregazione in secondi che determina la frequenza con cui l'autenticazione del dispositivo client aggrega le metriche e le invia all'agente di telemetria. Ciò non modifica la frequenza con cui le metriche vengono pubblicate, poiché l'agente di telemetria le pubblica ancora una volta al giorno.  
Impostazione predefinita: `3600`

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia `ERRORED` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.4.0 - v2.4.1 ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core, senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

`certificateAuthority`  
(Facoltativo) Opzioni di configurazione dell'autorità di certificazione per sostituire l'autorità intermedia del dispositivo principale con la propria autorità di certificazione intermedia. Questo oggetto contiene le seguenti informazioni.  
 Questo oggetto contiene le seguenti informazioni:    
URI del certificato  
La posizione del certificato. Può essere un URI del file system o un URI che punta a un certificato archiviato in un modulo di sicurezza hardware.  
`certificateChainUri`  
La posizione della catena di certificati per la CA del dispositivo principale. Questa dovrebbe essere la catena completa di certificati fino alla CA principale. Può essere un URI del file system o un URI che punta a una catena di certificati archiviata in un modulo di sicurezza hardware.  
`privateKeyUri`  
La posizione della chiave privata del dispositivo principale. Può essere un URI del file system o un URI che punta a una chiave privata del certificato memorizzata in un modulo di sicurezza hardware.

`security`  
(Facoltativo) Opzioni di configurazione della sicurezza per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni.    
`clientDeviceTrustDurationMinutes`  
Durata in minuti entro la quale è possibile considerare attendibili le informazioni di autenticazione di un dispositivo client prima che sia necessario riautenticarsi con il dispositivo principale. Il valore predefinito è 1.

`metrics`  
(Facoltativo) Le opzioni di metrica per questo dispositivo principale. Le metriche degli errori verranno visualizzate solo in caso di errore nell'autenticazione del dispositivo client. Questo oggetto contiene le seguenti informazioni:    
`disableMetrics`  
Se il `disableMetrics` campo è impostato su`true`, l'autenticazione del dispositivo client non raccoglierà le metriche.  
Impostazione predefinita: `false`  
`aggregatePeriodSeconds`  
Il periodo di aggregazione in secondi che determina la frequenza con cui l'autenticazione del dispositivo client aggrega le metriche e le invia all'agente di telemetria. Ciò non modifica la frequenza con cui le metriche vengono pubblicate, poiché l'agente di telemetria le pubblica ancora una volta al giorno.  
Impostazione predefinita: `3600`

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.3.x ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

`certificateAuthority`  
(Facoltativo) Opzioni di configurazione dell'autorità di certificazione per sostituire l'autorità intermedia del dispositivo principale con la propria autorità di certificazione intermedia. Questo oggetto contiene le seguenti informazioni.    
URI del certificato  
La posizione del certificato. Può essere un URI del file system o un URI che punta a un certificato archiviato in un modulo di sicurezza hardware.  
`certificateChainUri`  
La posizione della catena di certificati per la CA del dispositivo principale. Questa dovrebbe essere la catena completa di certificati fino alla CA principale. Può essere un URI del file system o un URI che punta a una catena di certificati archiviata in un modulo di sicurezza hardware.  
`privateKeyUri`  
La posizione della chiave privata del dispositivo principale. Può essere un URI del file system o un URI che punta a una chiave privata del certificato memorizzata in un modulo di sicurezza hardware.

`security`  
(Facoltativo) Opzioni di configurazione della sicurezza per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni.    
`clientDeviceTrustDurationMinutes`  
Durata in minuti durante la quale è possibile considerare attendibili le informazioni di autenticazione di un dispositivo client prima che sia necessario riautenticarsi con il dispositivo principale. Il valore predefinito è 1.

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.2.x ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

`performance`  
(Facoltativo) Le opzioni di configurazione delle prestazioni per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`maxActiveAuthTokens`  
(Facoltativo) Il numero massimo di token di autorizzazione attivi per i dispositivi client. È possibile aumentare questo numero per consentire a un numero maggiore di dispositivi client di connettersi a un dispositivo single-core senza riautenticarli.  
Impostazione predefinita: `2500`  
`cloudRequestQueueSize`  
(Facoltativo) Il numero massimo di Cloud AWS richieste da mettere in coda prima che questo componente rifiuti le richieste.  
Impostazione predefinita: `100`  
`maxConcurrentCloudRequests`  
(Facoltativo) Il numero massimo di richieste simultanee da inviare a. Cloud AWSÈ possibile aumentare questo numero per migliorare le prestazioni di autenticazione sui dispositivi principali in cui si connettono un gran numero di dispositivi client.  
Impostazione predefinita: `1`

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.1.x ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

`certificates`  <a name="client-device-auth-component-configuration-certificates"></a>
(Facoltativo) Le opzioni di configurazione del certificato per questo dispositivo principale. Questo oggetto contiene le seguenti informazioni:    
`serverCertificateValiditySeconds`  
(Facoltativo) La quantità di tempo (in secondi) dopo la quale scade il certificato del server MQTT locale. È possibile configurare questa opzione per personalizzare la frequenza con cui i dispositivi client si disconnettono e si riconnettono al dispositivo principale.  
Questo componente ruota il certificato del server MQTT locale 24 ore prima della scadenza. Il broker MQTT, ad esempio il [componente broker MQTT Moquette](mqtt-broker-moquette-component.md), genera un nuovo certificato e si riavvia. Quando ciò accade, tutti i dispositivi client collegati a questo dispositivo principale vengono disconnessi. I dispositivi client possono riconnettersi al dispositivo principale dopo un breve periodo di tempo.  
Impostazione predefinita: `604800` (7 giorni)  
Valore minimo: `172800` (2 giorni)  
Valore massimo: `864000` (10 giorni)

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------
#### [ v2.0.x ]

`deviceGroups`  <a name="client-device-auth-component-configuration-devicegroups"></a>
I gruppi di dispositivi sono gruppi di dispositivi client che dispongono delle autorizzazioni per connettersi e comunicare con un dispositivo principale. Utilizza le regole di selezione per identificare gruppi di dispositivi client e definisci *politiche di autorizzazione dei dispositivi client che specificano le* autorizzazioni per ciascun gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`formatVersion`  
La versione del formato per questo oggetto di configurazione.  
Seleziona una delle opzioni seguenti:  
+ `2021-03-05`  
`definitions`  
I gruppi di dispositivi per questo dispositivo principale. Ogni definizione specifica una *regola di selezione* per valutare se un dispositivo client è membro del gruppo. Ogni definizione specifica anche la politica di autorizzazione da applicare ai dispositivi client che corrispondono alla regola di selezione. Se un dispositivo client è membro di più gruppi di dispositivi, le autorizzazioni del dispositivo comprendono le politiche di autorizzazione di ciascun gruppo.  
Questo oggetto contiene le seguenti informazioni:    
`groupNameKey`  
Il nome di questo gruppo di dispositivi. Sostituiscilo *groupNameKey* con un nome che ti aiuti a identificare questo gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`selectionRule`  
La query che specifica quali dispositivi client sono membri di questo gruppo di dispositivi. Quando un dispositivo client si connette, il dispositivo principale valuta questa regola di selezione per determinare se il dispositivo client è membro di questo gruppo di dispositivi. Se il dispositivo client è un membro, il dispositivo principale utilizza la politica di questo gruppo di dispositivi per autorizzare le azioni del dispositivo client.  
Ogni regola di selezione comprende almeno una *clausola di regola di selezione*, che è una singola query di espressione che può corrispondere ai dispositivi client. Le regole di selezione utilizzano la stessa sintassi di interrogazione dell'indicizzazione AWS IoT della flotta. *Per ulteriori informazioni sulla sintassi delle regole di selezione, consulta la sintassi delle [query di indicizzazione AWS IoT della flotta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) nella Guida per gli sviluppatori.AWS IoT Core *  
Usa il carattere `*` jolly per abbinare più dispositivi client con una sola clausola di regola di selezione. È possibile utilizzare questo carattere jolly alla fine del nome dell'oggetto per abbinare i dispositivi client i cui nomi iniziano con una stringa specificata dall'utente. Puoi anche usare questo jolly per abbinare tutti i dispositivi client.  
Per selezionare un valore che contiene i due punti (`:`), evita i due punti con una barra rovesciata (). `\\` In formati come JSON, è necessario evitare i caratteri della barra rovesciata, quindi è necessario immettere due caratteri di barra rovesciata prima del carattere dei due punti. Ad esempio, specificate di selezionare una `thingName: MyTeam\\\\:ClientDevice1` cosa il cui nome è. `MyTeam:ClientDevice1`
È possibile specificare il seguente selettore:  
+ `thingName`— Il nome dell' AWS IoT oggetto di un dispositivo client.

**Example Esempio di regola di selezione**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi sono `MyClientDevice1` o`MyClientDevice2`.  

```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```

**Example Esempio di regola di selezione (usa caratteri jolly)**  
La seguente regola di selezione corrisponde ai dispositivi client i cui nomi iniziano con`MyClientDevice`.  

```
thingName: MyClientDevice*
```

**Example Esempio di regola di selezione (corrisponde a tutti i dispositivi)**  
La seguente regola di selezione corrisponde a tutti i dispositivi client.  

```
thingName: *
```  
`policyName`  
La politica di autorizzazione che si applica ai dispositivi client di questo gruppo di dispositivi. Specificate il nome di una politica che definite nell'`policies`oggetto.  
`policies`  
Le politiche di autorizzazione dei dispositivi client per i dispositivi client che si connettono al dispositivo principale. Ogni politica di autorizzazione specifica una serie di azioni e le risorse in cui un dispositivo client può eseguire tali azioni.  
Questo oggetto contiene le seguenti informazioni:    
`policyNameKey`  
Il nome di questa politica di autorizzazione. Sostituiscilo *policyNameKey* con un nome che ti aiuti a identificare questa politica di autorizzazione. Questo nome di policy viene utilizzato per definire quale criterio si applica a un gruppo di dispositivi.  
Questo oggetto contiene le seguenti informazioni:    
`statementNameKey`  
Il nome di questa dichiarazione politica. Sostituire *statementNameKey* con un nome che consenta di identificare questa dichiarazione politica.  
Questo oggetto contiene le seguenti informazioni:    
`operations`  
L'elenco delle operazioni per consentire l'utilizzo delle risorse in questa politica.  
È possibile includere una delle seguenti operazioni:  
+ `mqtt:connect`— Concede l'autorizzazione alla connessione al dispositivo principale. I dispositivi client devono disporre di questa autorizzazione per connettersi a un dispositivo principale.

  Questa operazione supporta le seguenti risorse:
  + `mqtt:clientId:deviceClientId`— Limita l'accesso in base all'ID client utilizzato da un dispositivo client per connettersi al broker MQTT del dispositivo principale. Sostituiscilo *deviceClientId* con l'ID client da utilizzare.
+ `mqtt:publish`— Concede l'autorizzazione a pubblicare messaggi MQTT sugli argomenti.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topic"></a>`mqtt:topic:mqttTopic`— Limita l'accesso in base all'argomento MQTT in cui un dispositivo client pubblica un messaggio. Sostituisci *mqttTopic* con l'argomento da utilizzare.

    Questa risorsa non supporta i caratteri jolly degli argomenti MQTT.
+ `mqtt:subscribe`— Concede l'autorizzazione a sottoscrivere i filtri degli argomenti MQTT per ricevere messaggi.

  Questa operazione supporta le seguenti risorse:
  + <a name="client-device-authorization-policy-resource-mqtt-topicfilter"></a>`mqtt:topicfilter:mqttTopicFilter`— Limita l'accesso in base agli argomenti MQTT in cui un dispositivo client può iscriversi ai messaggi. *mqttTopicFilter*Sostituiscilo con il filtro per argomenti da utilizzare.

    Questa risorsa supporta i caratteri jolly `+` degli argomenti `#` MQTT. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide AWS IoT Core .*

    Il dispositivo client può sottoscrivere gli stessi filtri tematici consentiti. Ad esempio, se consenti al dispositivo client di sottoscrivere la `mqtt:topicfilter:client/+/status` risorsa, il dispositivo client può abbonarsi `client/+/status` ma non farlo`client/client1/status`.
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le azioni.  
`resources`  
L'elenco delle risorse per consentire le operazioni previste da questa politica. Specificare le risorse che corrispondono alle operazioni di questa politica. Ad esempio, è possibile specificare un elenco di risorse tematiche MQTT (`mqtt:topic:mqttTopic`) in una politica che specifica l'`mqtt:publish`operazione.  
È possibile specificare il carattere `*` jolly per consentire l'accesso a tutte le risorse. Non è possibile utilizzare il carattere `*` jolly per abbinare identificatori di risorse parziali. Ad esempio, puoi specificare**"resources": "\$1"**, ma non puoi specificare. **"resources": "mqtt:clientId:\$1"**  
`statementDescription`  
(Facoltativo) Una descrizione per questa dichiarazione politica.

**Example Esempio: aggiornamento dell'unione della configurazione (utilizzando una politica restrittiva)**  <a name="client-device-auth-component-configuration-example-restrictive"></a>
La configurazione di esempio seguente specifica di consentire la connessione ai dispositivi client i cui nomi iniziano con e publish/subscribe su tutti `MyClientDevice` gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyDeviceGroup": {
        "selectionRule": "thingName: MyClientDevice*",
        "policyName": "MyRestrictivePolicy"
      }
    },
    "policies": {
      "MyRestrictivePolicy": {
        "AllowConnect": {
          "statementDescription": "Allow client devices to connect.",
          "operations": [
            "mqtt:connect"
          ],
          "resources": [
            "*"
          ]
        },
        "AllowPublish": {
          "statementDescription": "Allow client devices to publish on test/topic.",
          "operations": [
            "mqtt:publish"
          ],
          "resources": [
            "mqtt:topic:test/topic"
          ]
        },
        "AllowSubscribe": {
          "statementDescription": "Allow client devices to subscribe to test/topic/response.",
          "operations": [
            "mqtt:subscribe"
          ],
          "resources": [
            "mqtt:topicfilter:test/topic/response"
          ]
        }
      }
    }
  }
}
```

**Example Esempio: aggiornamento basato sull'unione della configurazione (utilizzando una politica permissiva)**  <a name="client-device-auth-component-configuration-example-permissive"></a>
La configurazione di esempio seguente specifica di consentire la connessione a tutti i dispositivi client e publish/subscribe su tutti gli argomenti.  

```
{
  "deviceGroups": {
    "formatVersion": "2021-03-05",
    "definitions": {
      "MyPermissiveDeviceGroup": {
        "selectionRule": "thingName: *",
        "policyName": "MyPermissivePolicy"
      }
    },
    "policies": {
      "MyPermissivePolicy": {
        "AllowAll": {
          "statementDescription": "Allow client devices to perform all actions.",
          "operations": [
            "*"
          ],
          "resources": [
            "*"
          ]
        }
      }
    }
  }
}
```

------

## File di registro locale
<a name="client-device-auth-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="client-device-auth-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.5.5  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.5.4  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.5.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.5.2  |  Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.  | 
|  2.5.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.5.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.4.5  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html) | 
|  2.4.4  | Versione aggiornata per Greengrass nucleus versione 2.12.0. | 
|  2.4.3  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.4.2  |  <a name="changelog-client-device-auth-2.4.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.4.1  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.4.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.3.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.3.0  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  Nuove funzionalità [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.2.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.2.1  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.2.0  |  <a name="changelog-client-device-auth-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.0.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/client-device-auth-component.html)  | 
|  2.0.2  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.1  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.0  |  Versione iniziale.  | 

# CloudWatch metriche
<a name="cloudwatch-metrics-component"></a>

Il componente Amazon CloudWatch metrics (`aws.greengrass.Cloudwatch`) pubblica metriche personalizzate dai dispositivi core Greengrass su Amazon. CloudWatch Il componente consente ai componenti di pubblicare CloudWatch metriche, che possono essere utilizzate per monitorare e analizzare l'ambiente del dispositivo principale Greengrass. Per ulteriori informazioni, consulta [Using Amazon CloudWatch metrics](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/working_with_metrics.html) nella *Amazon CloudWatch User Guide*.

Per pubblicare una CloudWatch metrica con questo componente, pubblica un messaggio su un argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente sottoscrive l'argomento di pubblicazione/sottoscrizione `cloudwatch/metric/put` [locale](ipc-publish-subscribe.md). È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

Questo componente raggruppa in batch le metriche che si trovano nello stesso spazio dei nomi e le pubblica a intervalli regolari. CloudWatch 

**Nota**  
Questo componente offre funzionalità simili al connettore Metrics in V1. CloudWatch AWS IoT Greengrass Per ulteriori informazioni, consulta [CloudWatch Metrics Connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/cloudwatch-metrics-connector.html) nella *AWS IoT Greengrass V1* Developer Guide.

**Topics**
+ [Versioni](#cloudwatch-metrics-component-versions)
+ [Tipo](#cloudwatch-metrics-component-type)
+ [Sistema operativo](#cloudwatch-metrics-component-os-support)
+ [Requisiti](#cloudwatch-metrics-component-requirements)
+ [Dipendenze](#cloudwatch-metrics-component-dependencies)
+ [Configurazione](#cloudwatch-metrics-component-configuration)
+ [Dati di input](#cloudwatch-metrics-component-input-data)
+ [Dati di output](#cloudwatch-metrics-component-output-data)
+ [Licenze](#cloudwatch-metrics-component-licenses)
+ [File di registro locale](#cloudwatch-metrics-component-log-file)
+ [Changelog](#cloudwatch-metrics-component-changelog)
+ [Consulta anche](#cloudwatch-metrics-component-see-also)

## Versioni
<a name="cloudwatch-metrics-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.1.x
+ 2.0.x

Per informazioni sulle modifiche apportate a ciascuna versione del componente, consulta il [changelog](#cloudwatch-metrics-component-changelog).

## Tipo
<a name="cloudwatch-metrics-component-type"></a>

------
#### [ v3.x ]

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

------
#### [ v2.x ]

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a>componente è un componente Lambda () `aws.greengrass.lambda`. [Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.](lambda-launcher-component.md)

------

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="cloudwatch-metrics-component-os-support"></a>

------
#### [ v3.x ]

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

------
#### [ v2.x ]

Questo componente può essere installato solo sui dispositivi principali di Linux.

------

## Requisiti
<a name="cloudwatch-metrics-component-requirements"></a>

Questo componente ha i seguenti requisiti:

------
#### [ 3.x ]
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire l'`cloudwatch:PutMetricData`azione, come illustrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "cloudwatch:PutMetricData"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

------

  Per ulteriori informazioni, consulta il [riferimento CloudWatch alle autorizzazioni di](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *Amazon nella Amazon CloudWatch User Guide*.

------
#### [ 2.x ]
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire l'`cloudwatch:PutMetricData`azione, come illustrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "cloudwatch:PutMetricData"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

------

  Per ulteriori informazioni, consulta il [riferimento CloudWatch alle autorizzazioni di](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *Amazon nella Amazon CloudWatch User Guide*.
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, devi unire il seguente aggiornamento di configurazione per il [componente legacy del router di abbonamento](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) quando distribuisci questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-cloudwatch": {
        "id": "aws-greengrass-cloudwatch",
        "source": "component:aws.greengrass.Cloudwatch",
        "subject": "cloudwatch/metric/put/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-cloudwatch": {
        "id": "aws-greengrass-cloudwatch",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version",
        "subject": "cloudwatch/metric/put/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sostituiscilo con quello Regione AWS che usi.
  + Sostituisci *version* con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass) e cerca la coppia chiave-valore della **funzione Lambda**. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di sottoscrizione legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).

------

### Endpoint e porte
<a name="cloudwatch-metrics-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `monitoring.region.amazonaws.com`  | 443 | Sì |  Metriche di caricamento. CloudWatch   | 

## Dipendenze
<a name="cloudwatch-metrics-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#cloudwatch-metrics-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 3.2.0 ]

La tabella seguente elenca le dipendenze per le versioni 3.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 3.0.0 - 3.1.0 ]

La tabella seguente elenca le dipendenze per le versioni da 3.0.0 a 3.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 2.1.4 - 2.1.9 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.4 a 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 - 2.1.8 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.4 e 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 - 2.1.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.2 e 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.8 a 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | >=1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="cloudwatch-metrics-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v3.x ]

 `PublishInterval`   
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi le metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, ovvero senza raggruppamento in batch, specificate. `0`  
Il componente viene pubblicato CloudWatch dopo aver ricevuto 20 metriche nello stesso spazio dei nomi o dopo l'intervallo specificato.  
Il componente non specifica l'ordine di pubblicazione degli eventi.
Questo valore può essere al massimo di 900 secondi.  
Impostazione predefinita: 10 secondi

 `MaxMetricsToRetain`   
(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.  
Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato spazio dei nomi sostituiscono solo le metriche nello stesso spazio dei nomi.  
Se il processo host per il componente viene interrotto, il componente non salva le metriche. Ciò può accadere durante una distribuzione o al riavvio del dispositivo principale, ad esempio.
Questo valore deve essere almeno 2.000 parametri.  
Impostazione predefinita: 5.000 metriche

`InputTopic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `true` for`PubSubToIoTCore`, è possibile utilizzare i caratteri jolly MQTT (\$1 e \$1) in questo argomento.  
Impostazione predefinita: `cloudwatch/metric/put`

`OutputTopic`  
(Facoltativo) L'argomento su cui il componente pubblica le risposte sullo stato.  
Impostazione predefinita: `cloudwatch/metric/put/status`

`PubSubToIoTCore`  
(Facoltativo) Valore di stringa che definisce se pubblicare e sottoscrivere argomenti AWS IoT Core MQTT. I valori supportati sono `true` e `false`.  
Impostazione predefinita: `false`

`LogLevel`  
(Facoltativo) Il livello di registrazione per il componente. Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  
+ `DEBUG`
+ `INFO`
+ `WARNING`
+ `ERROR`
+ `CRITICAL`
Impostazione predefinita: `INFO`

`UseInstaller`  
(Facoltativo) Valore booleano che definisce se utilizzare lo script di installazione in questo componente per installare le dipendenze SDK di questo componente.  
Imposta questo valore su `false` se desideri utilizzare uno script personalizzato per installare le dipendenze o se desideri includere le dipendenze di runtime in un'immagine Linux predefinita. Per utilizzare questo componente, è necessario installare le seguenti librerie, comprese le eventuali dipendenze, e renderle disponibili all'utente predefinito del sistema Greengrass.  
+ [SDK per dispositivi AWS IoT v2 per Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS SDK per Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
Impostazione predefinita: `true`

`PublishRegion`  
(Facoltativo) L'oggetto Regione AWS su cui pubblicare CloudWatch le metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

`accessControl`  
(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare e sottoscrivere gli argomenti specificati. Se si specificano valori personalizzati per `InputTopic` e`OutputTopic`, è necessario aggiornare i valori delle risorse in questo oggetto.   
Impostazione predefinita:   

```
{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  }
}
```

**Example Esempio: fusione e aggiornamento della configurazione**  

```
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
```

------
#### [ v2.x ]

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

 `lambdaParams`   
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
 `EnvironmentVariables`   
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
 `PUBLISH_INTERVAL`   
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi le metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, ovvero senza raggruppamento in batch, specificate. `0`  
Il componente viene pubblicato CloudWatch dopo aver ricevuto 20 metriche nello stesso spazio dei nomi o dopo l'intervallo specificato.  
Il componente non garantisce l'ordine di pubblicazione degli eventi.
Questo valore può essere al massimo di 900 secondi.  
Impostazione predefinita: 10 secondi  
 `MAX_METRICS_TO_RETAIN`   
(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.  
Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato spazio dei nomi sostituiscono solo le metriche nello stesso spazio dei nomi.  
Se il processo host per il componente viene interrotto, il componente non salva le metriche. Ciò può accadere durante una distribuzione o al riavvio del dispositivo principale, ad esempio.
Questo valore deve essere almeno 2.000 parametri.  
Impostazione predefinita: 5.000 metriche  
 `PUBLISH_REGION`   
(Facoltativo) L'oggetto Regione AWS su cui pubblicare le CloudWatch metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
Impostazione predefinita: `GreengrassContainer`

 `containerParams`   
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
 `memorySize`   
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 64 MB (65.535 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente sottoscrive la sottoscrizione per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`and`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  

```
{
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  

```
{
  "containerMode": "NoContainer"
}
```

------

## Dati di input
<a name="cloudwatch-metrics-component-input-data"></a>

Questo componente accetta le metriche sul seguente argomento e le pubblica su. CloudWatch <a name="connector-component-local-publish"></a>Per impostazione predefinita, questo componente sottoscrive i messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md). 

A partire dalla versione del componente v3.0.0, è possibile facoltativamente configurare questo componente per sottoscrivere un argomento MQTT impostando il parametro di configurazione su. `PubSubToIoTCore` `true` Per ulteriori informazioni sulla pubblicazione di messaggi su un argomento MQTT nei componenti personalizzati, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)

 **Argomento predefinito:** `cloudwatch/metric/put` 

<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.

 `request`   
La metrica in questo messaggio.  
L'oggetto della richiesta contiene i dati dei parametri da pubblicare in CloudWatch. I valori metrici devono soddisfare le specifiche dell'[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)operazione.  
Tipo: `object` che contiene le seguenti informazioni:    
 `namespace`   
Lo spazio dei nomi definito dall'utente per i dati metrici in questa richiesta. CloudWatch utilizza i namespace come contenitori per i punti dati metrici.  
Non è possibile specificare uno spazio dei nomi che inizi con la stringa riservata. `AWS/`
Tipo: `string`  
Modello valido: `[^:].*`  
 `metricData`   
I dati del parametro.  
Tipo: `object` che contiene le seguenti informazioni:    
 `metricName`   
Nome del parametro.  
Tipo: `string`  
 `value`   
Il valore del parametro.  
CloudWatch rifiuta valori troppo piccoli o troppo grandi. Il valore deve essere compreso tra `8.515920e-109` e `1.174271e+108` (Base 10) o `2e-360` e `2e360` (Base 2). CloudWatch non supporta valori speciali come `NaN``+Infinity`, e`-Infinity`.
Tipo: `double`  
 `dimensions`   
(Facoltativo) Le dimensioni della metrica. Le dimensioni forniscono ulteriori informazioni sul parametro e sui relativi dati. Un parametro è in grado di definire fino a 10 dimensioni.  
Questo componente include automaticamente una dimensione denominata`coreName`, dove il valore è il nome del dispositivo principale.  
Tipo: `array` di oggetti che contengono ciascuno le seguenti informazioni:    
 `name`   
(Facoltativo) Il nome della dimensione.  
Tipo: `string`  
 `value`   
(Facoltativo) Il valore della dimensione.  
Tipo: `string`  
 `timestamp`   
(Facoltativo) L'ora in cui sono stati ricevuti i dati metrici, espressa in secondi nell'epoca Unix.  
Il valore predefinito è l'ora in cui il componente riceve il messaggio.  
Tipo: `double`  
Se utilizzi tra le versioni 2.0.3 e 2.0.7 di questo componente, ti consigliamo di recuperare il timestamp separatamente per ogni metrica quando invii più metriche da un'unica fonte. Non utilizzare una variabile per memorizzare il timestamp.  
 `unit`   
(Facoltativo) L'unità della metrica.  
Tipo: `string`  
Valori validi: `Seconds``Microseconds`,`Milliseconds`,`Bytes`,`Kilobytes`,`Megabytes`,`Gigabytes`,`Terabytes`,`Bits`,`Kilobits`,`Megabits`,,`Gigabits`,`Terabits`,`Percent`,`Count`,`Bytes/Second`,`Kilobytes/Second`,`Megabytes/Second`,`Gigabytes/Second`,`Terabytes/Second`,`Bits/Second`,`Kilobits/Second`,`Megabits/Second`,`Gigabits/Second`,`Terabits/Second`, `Count/Second` `None`  
L’impostazione predefinita è `None`.

**Nota**  
Tutte le quote che si applicano all' CloudWatch `PutMetricData`API si applicano alle metriche pubblicate con questo componente. Le seguenti quote sono particolarmente importanti:  
Limite di 40 KB per il payload dell'API
20 parametri per ciascuna richiesta API
150 transazioni al secondo (TPS) per l'API `PutMetricData`
Per ulteriori informazioni, consulta le [quote CloudWatch di servizio nella Guida](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) per l'*CloudWatch utente*.

**Example Input di esempio**  

```
{
  "request": {
    "namespace": "Greengrass",
    "metricData": {
      "metricName": "latency",
      "dimensions": [
        {
          "name": "hostname",
          "value": "test_hostname"
        }
      ],
      "timestamp": 1539027324,
      "value": 123.0,
      "unit": "Seconds"
    }
  }
}
```

## Dati di output
<a name="cloudwatch-metrics-component-output-data"></a>

 <a name="connector-component-output-data-pubsub"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente publish/subscribe argomento locale. Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consulta[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md). 

Facoltativamente, è possibile configurare questo componente per la pubblicazione su un argomento MQTT impostando il parametro di `PubSubToIoTCore` configurazione su. `true` Per ulteriori informazioni sulla sottoscrizione ai messaggi su un argomento MQTT nei componenti personalizzati, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)

**Nota**  
Per impostazione predefinita, le versioni dei componenti 2.0.x pubblicano le risposte come dati di output su un argomento MQTT. È necessario specificare l'argomento come contenuto `subject` nella configurazione del componente [legacy del router di abbonamento](legacy-subscription-router-component.md).

 **Argomento predefinito:** `cloudwatch/metric/put/status` 

**Example Output di esempio: Operazione riuscita**  
La risposta include lo spazio dei nomi dei dati metrici e il `RequestId` campo della risposta. CloudWatch   

```
{
  "response": {
    "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
    "namespace": "Greengrass",
    "status": "success"
  }
}
```

**Example Esempio di output: Errore**  

```
{
  "response" : {
    "namespace": "Greengrass",
    "error": "InvalidInputException",
    "error_message": "cw metric is invalid",
    "status": "fail"
  }
}
```

**Nota**  <a name="connector-component-retryable-error"></a>
Se il componente rileva un errore che può essere riprovato, ad esempio un errore di connessione, riprova la pubblicazione nel batch successivo.

## Licenze
<a name="cloudwatch-metrics-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:<a name="boto-3-licenses"></a>
+ [AWS SDK per Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## File di registro locale
<a name="cloudwatch-metrics-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="cloudwatch-metrics-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.

------
#### [ v3.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  3.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  3.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  3.0.0  |  <a name="changelog-cloudwatch-metrics-3.0.0-major-version-changes"></a>Questa versione del componente CloudWatch metrics prevede parametri di configurazione diversi rispetto alla versione 2.x. Se utilizzi una configurazione non predefinita per la versione 2.x e desideri eseguire l'aggiornamento dalla v2.x alla v3.x, devi aggiornare la configurazione del componente. [Per ulteriori informazioni, consulta Configurazione del componente metrics. CloudWatch](#cloudwatch-metrics-component-configuration) <a name="changelog-cloudwatch-metrics-3.0.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 

------
#### [ v2.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.8  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  2.0.8  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

------

## Consulta anche
<a name="cloudwatch-metrics-component-see-also"></a>
+ [Utilizzo dei CloudWatch parametri di Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) nella *Amazon CloudWatch User Guide*
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)nell'*Amazon CloudWatch API Reference*

# AWS IoT Device Defender
<a name="device-defender-component"></a>

Il AWS IoT Device Defender componente (`aws.greengrass.DeviceDefender`) notifica agli amministratori le modifiche allo stato dei dispositivi principali Greengrass. Ciò consente di identificare un comportamento anomalo che potrebbe indicare la compromissione del dispositivo. Per ulteriori informazioni, consulta la sezione [AWS IoT Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) nella *Guida per gli sviluppatori di AWS IoT Core *.

Questo componente legge le metriche di sistema sul dispositivo principale. Quindi, pubblica le metriche su. AWS IoT Device Defender*Per ulteriori informazioni su come leggere e interpretare le metriche riportate da questo componente, consulta la sezione [Specifiche del documento Device Metrics nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec) Guide.AWS IoT Core *

**Nota**  
Questo componente fornisce funzionalità simili al connettore Device Defender in. AWS IoT Greengrass V1 Per ulteriori informazioni, consulta [Device Defender connector nella Guida](https://docs.aws.amazon.com/greengrass/latest/developerguide/device-defender-connector.html) per gli *AWS IoT Greengrass V1 sviluppatori*.

**Topics**
+ [Versioni](#device-defender-component-versions)
+ [Tipo](#device-defender-component-type)
+ [Sistema operativo](#device-defender-component-os-support)
+ [Requisiti](#device-defender-component-requirements)
+ [Dipendenze](#device-defender-component-dependencies)
+ [Configurazione](#device-defender-component-configuration)
+ [Dati di input](#device-defender-component-input-data)
+ [Dati di output](#device-defender-component-output-data)
+ [File di registro locale](#device-defender-component-log-file)
+ [Licenze](#device-defender-component-licenses)
+ [Changelog](#device-defender-component-changelog)

## Versioni
<a name="device-defender-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 3.1.x
+ 3.0.x
+ 2,0x

[Per informazioni sulle modifiche apportate a ciascuna versione del componente, consulta il changelog.](#device-defender-component-changelog)

## Tipo
<a name="device-defender-component-type"></a>

------
#### [ v3.x ]

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

------
#### [ v2.x ]

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a>componente è un componente Lambda () `aws.greengrass.lambda`. [Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.](lambda-launcher-component.md)

------

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="device-defender-component-os-support"></a>

------
#### [ v3.x ]

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

------
#### [ v2.x ]

Questo componente può essere installato solo sui dispositivi principali di Linux.

------

## Requisiti
<a name="device-defender-component-requirements"></a>

Questo componente ha i seguenti requisiti:

------
#### [ v3.x ]
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ AWS IoT Device Defender configurato per utilizzare la funzione Detect per monitorare le violazioni. Per ulteriori informazioni, consulta [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) nella *AWS IoT Core Developer Guide*.

------
#### [ v2.x ]
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ AWS IoT Device Defender configurato per utilizzare la funzione Detect per monitorare le violazioni. Per ulteriori informazioni, consulta [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) nella *AWS IoT Core Developer Guide*.
+ La libreria [psutil](https://pypi.org/project/psutil/) installata sul dispositivo principale. La versione 5.7.0 è l'ultima versione verificata per funzionare con il componente.
+ La libreria [cbor](https://pypi.org/project/cbor/) installata sul dispositivo principale. La versione 1.0.0 è l'ultima versione verificata per funzionare con il componente.
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il componente [legacy del router di abbonamento (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente](legacy-subscription-router-component.md). Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-device-defender": {
        "id": "aws-greengrass-device-defender",
        "source": "component:aws.greengrass.DeviceDefender",
        "subject": "$aws/things/+/defender/metrics/json",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-device-defender": {
        "id": "aws-greengrass-device-defender",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-device-defender:version",
        "subject": "$aws/things/+/defender/metrics/json",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sostituiscilo con quello Regione AWS che usi.
  + Sostituisci *version* con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass) e cerca la coppia chiave-valore della **funzione Lambda**. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di sottoscrizione legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).

------

## Dipendenze
<a name="device-defender-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#device-defender-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 3.1.1 ]

La tabella seguente elenca le dipendenze per la versione 3.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 3.0.0 - 3.0.2 ]

La tabella seguente elenca le dipendenze per le versioni da 3.0.0 a 3.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 2.0.12 - 2.0.17 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.12 a 2.0.17 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.12 - 2.0.16 ]

La tabella seguente elenca le dipendenze per la versione 2.0.16 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.10 - 2.0.11 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.10 e 2.0.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.9 ]

La tabella seguente elenca le dipendenze per la versione 2.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 ]

La tabella seguente elenca le dipendenze per la versione 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | >=1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="device-defender-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v3.x ]

`PublishRetryCount`  
Il numero di volte in cui la pubblicazione verrà ritentata. Questa funzionalità è disponibile nella versione 3.1.1.  
Il valore minimo è 0.  
Il massimo è 72.  
Impostazione predefinita: 5

`SampleIntervalSeconds`  
(Facoltativo) La quantità di tempo in secondi tra ogni ciclo in cui il componente raccoglie e riporta le metriche.  
Il valore minimo è di 300 secondi (5 minuti).  
Impostazione predefinita: 300 secondi

 `UseInstaller`   
(Facoltativo) Valore booleano che definisce se utilizzare lo script di installazione in questo componente per installarne le dipendenze.  
Imposta questo valore su `false` se desideri utilizzare uno script personalizzato per installare le dipendenze o se desideri includere le dipendenze di runtime in un'immagine Linux predefinita. Per utilizzare questo componente, è necessario installare le seguenti librerie, comprese le eventuali dipendenze, e renderle disponibili all'utente predefinito del sistema Greengrass.  
+ [SDK per dispositivi AWS IoT v2 per Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [libreria cbor](https://pypi.org/project/cbor/). La versione 1.0.0 è l'ultima versione verificata per funzionare con il componente.
+ [libreria psutil](https://pypi.org/project/psutil/). La versione 5.7.0 è l'ultima versione verificata per funzionare con il componente.
Se si utilizza la versione 3.0.0 o 3.0.1 di questo componente su dispositivi principali configurati per l'utilizzo di un proxy HTTPS, è necessario impostare questo valore su. `false` Lo script di installazione non supporta il funzionamento con un proxy HTTPS in queste versioni di questo componente.
Impostazione predefinita: `true`

------
#### [ v2.x ]

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`PROCFS_PATH`  
(Facoltativo) Il percorso della `/proc` cartella.  
+ Per eseguire questo componente in un contenitore, utilizzate il valore predefinito,`/host-proc`. Per impostazione predefinita, il componente viene eseguito in un contenitore.
+ Per eseguire questo componente in modalità senza contenitore, specificare `/proc` questo parametro.
Default: `/host-proc`. Questo è il percorso predefinito in cui questo componente monta la `/proc` cartella nel contenitore.  
Questo componente ha accesso in sola lettura a questa cartella.  
`SAMPLE_INTERVAL_SECONDS`  
(Facoltativo) La quantità di tempo in secondi tra ogni ciclo in cui il componente raccoglie e riporta le metriche.  
Il valore minimo è di 300 secondi (5 minuti).  
Impostazione predefinita: 300 secondi

`containerMode`  
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.

  Se si specifica questa opzione, è necessario specificare `/proc` il parametro della variabile di `PROCFS_PATH` ambiente.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 50.000 KB.

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente si iscrive per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`and`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "PROCFS_PATH": "/host_proc"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "PROCFS_PATH": "/proc"
    }
  },
  "containerMode": "NoContainer"
}
```

------

## Dati di input
<a name="device-defender-component-input-data"></a>

Questo componente non accetta messaggi come dati di input.

## Dati di output
<a name="device-defender-component-output-data"></a>

Questo componente pubblica le metriche di sicurezza relative al seguente argomento riservato a. AWS IoT Device Defender Questo componente lo sostituisce *coreDeviceName* con il nome del dispositivo principale quando pubblica le metriche.

**Argomento (MQTT)AWS IoT Core :** `$aws/things/coreDeviceName/defender/metrics/json`

**Example Output di esempio**  

```
{
  "header": {
    "report_id": 1529963534,
    "version": "1.0"
  },
  "metrics": {
    "listening_tcp_ports": {
      "ports": [
        {
          "interface": "eth0",
          "port": 24800
        },
        {
          "interface": "eth0",
          "port": 22
        },
        {
          "interface": "eth0",
          "port": 53
        }
      ],
      "total": 3
    },
    "listening_udp_ports": {
      "ports": [
        {
          "interface": "eth0",
          "port": 5353
        },
        {
          "interface": "eth0",
          "port": 67
        }
      ],
      "total": 2
    },
    "network_stats": {
      "bytes_in": 1157864729406,
      "bytes_out": 1170821865,
      "packets_in": 693092175031,
      "packets_out": 738917180
    },
    "tcp_connections": {
      "established_connections":{
        "connections": [
          {
            "local_interface": "eth0",
            "local_port": 80,
            "remote_addr": "192.168.0.1:8000"
          },
          {
            "local_interface": "eth0",
            "local_port": 80,
            "remote_addr": "192.168.0.1:8000"
          }
        ],
        "total": 2
      }
    }
  }
}
```

*Per ulteriori informazioni sulle metriche riportate da questo componente, consulta la sezione [Specifiche del documento Device Metrics](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec) nella Developer Guide.AWS IoT Core *

## File di registro locale
<a name="device-defender-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.DeviceDefender.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.DeviceDefender.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.log -Tail 10 -Wait
  ```

------

## Licenze
<a name="device-defender-component-licenses"></a>

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="device-defender-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.

------
#### [ v3.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  3.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/device-defender-component.html)  | 
|  3.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/device-defender-component.html)  | 
|  3.0.1  |  Risolve un problema relativo al modo in cui il componente calcola i valori delta per le metriche.  | 
|  3.0.0  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  Versione iniziale.  | 

------
#### [ v2.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.17  |  Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.  | 
|  2.0.16  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.  | 
|  2.0.11  |  Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.  | 
|  2.0.10  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.0.9  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.0.8  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

------

# Spooler del disco
<a name="disk-spooler-component"></a>

Il componente disk spooler (`aws.greengrass.DiskSpooler`) offre un'opzione di archiviazione persistente per i messaggi trasferiti dai dispositivi core Greengrass a. AWS IoT Core Questo componente memorizzerà questi messaggi in uscita su disco.

**Topics**
+ [Versioni](#disk-spooler-component-versions)
+ [Tipo](#disk-spooler-component-type)
+ [Sistema operativo](#disk-spooler-component-os-support)
+ [Requisiti](#disk-spooler-component-requirements)
+ [Dipendenze](#disk-spooler-component-dependencies)
+ [Utilizzo](#disk-spooler-component-usage)
+ [File di registro locale](#disk-spooler-component-log-file)
+ [Changelog](#disk-spooler-component-changelog)

## Versioni
<a name="disk-spooler-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.0.x

## Tipo
<a name="disk-spooler-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="disk-spooler-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="disk-spooler-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ `storageType`deve essere impostato `Disk` per utilizzare questo componente. Puoi impostarlo nella configurazione [Greengrass nucleus](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration).
+ `maxSizeInBytes`non deve essere configurato per occupare una dimensione superiore allo spazio disponibile sul dispositivo. Puoi impostarlo nella configurazione [Greengrass nucleus](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration).
+ Il componente disk spooler è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="disk-spooler-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#disk-spooler-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.0.7 ]

La tabella seguente elenca le dipendenze per la versione 1.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.17.0 | Rigidi | 

------
#### [ 1.0. ]

La tabella seguente elenca le dipendenze per la versione 1.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.16.0 | Rigidi | 

------
#### [ 1.0.5 ]

La tabella seguente elenca le dipendenze per la versione 1.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.15.0 | Rigidi | 

------
#### [ 1.0.4 ]

La tabella seguente elenca le dipendenze per la versione 1.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.14.0 | Rigidi | 

------
#### [ 1.0.1 – 1.0.3 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.1 a 1.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.13.0 | Rigidi | 

------
#### [ 1.0.0 ]

La tabella seguente elenca le dipendenze per la versione 1.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Utilizzo
<a name="disk-spooler-component-usage"></a>

Per utilizzare il componente disk spooler, `aws.greengrass.DiskSpooler` deve essere distribuito.

Per configurare e utilizzare questo componente, è necessario impostare su. `pluginName` `aws.greengrass.DiskSpooler`

## File di registro locale
<a name="disk-spooler-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="disk-spooler-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.0.7  |  Versione aggiornata per Greengrass nucleus versione 2.16.0.  | 
|  1.0.6  |  Versione aggiornata per la versione 2.15.0 di Greengrass nucleus.  | 
|  1.0.5  |  Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.  | 
|  1.0.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/disk-spooler-component.html)  | 
|  1.0.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/disk-spooler-component.html)  | 
|  1.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/disk-spooler-component.html)  | 
|  1.0.1  |  Versione aggiornata per Greengrass nucleus versione 2.12.0.  | 
|  1.0.0  |  Versione iniziale.  | 

# Gestore di applicazioni Docker
<a name="docker-application-manager-component"></a>

Il componente Docker application manager (`aws.greengrass.DockerApplicationManager`) consente AWS IoT Greengrass di scaricare immagini Docker da registri di immagini pubblici e registri privati ospitati su Amazon Elastic Container Registry (Amazon ECR) Elastic Container Registry (Amazon ECR). Consente inoltre di AWS IoT Greengrass gestire automaticamente le credenziali per scaricare in modo sicuro immagini da archivi privati in Amazon ECR.

Quando sviluppi un componente personalizzato che esegue un contenitore Docker, includi il gestore delle applicazioni Docker come dipendenza per scaricare le immagini Docker specificate come artefatti nel componente. Per ulteriori informazioni, consulta [Esegui un contenitore Docker](run-docker-container.md).

**Topics**
+ [Versioni](#docker-application-manager-component-versions)
+ [Tipo](#docker-application-manager-component-type)
+ [Sistema operativo](#docker-application-manager-component-os-support)
+ [Requisiti](#docker-application-manager-component-requirements)
+ [Dipendenze](#docker-application-manager-component-dependencies)
+ [Configurazione](#docker-application-manager-component-configuration)
+ [File di registro locale](#docker-application-manager-component-log-file)
+ [Changelog](#docker-application-manager-component-changelog)
+ [Consulta anche](#docker-application-manager-component-see-also)

## Versioni
<a name="docker-application-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x

## Tipo
<a name="docker-application-manager-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico (`aws.greengrass.generic`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="docker-application-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="docker-application-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ <a name="docker-engine-requirement"></a>[Docker Engine](https://docs.docker.com/engine/) 1.9.1 o versione successiva installato sul dispositivo principale Greengrass. La versione 20.10 è l'ultima versione verificata per funzionare con il software Core. AWS IoT Greengrass È necessario installare Docker direttamente sul dispositivo principale prima di distribuire componenti che eseguono contenitori Docker.
+ <a name="docker-daemon-requirement"></a>Il daemon Docker è stato avviato e funzionante sul dispositivo principale prima di distribuire questo componente. 
+ Immagini Docker archiviate in una delle seguenti fonti di immagini supportate:
  + Archivi di immagini pubblici e privati in Amazon Elastic Container Registry (Amazon ECR)
  + Archivio pubblico di Docker Hub
  + Registro pubblico affidabile di Docker
+ Immagini Docker incluse come artefatti nei componenti del contenitore Docker personalizzati. Usa i seguenti formati URI per specificare le tue immagini Docker:<a name="docker-image-artifact-uri"></a>
  + Immagine Amazon ECR privata: `docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]`
  + Immagine pubblica di Amazon ECR: `docker:public.ecr.aws/repository/image[:tag|@digest]`
  + Immagine pubblica di Docker Hub: `docker:name[:tag|@digest]`

  Per ulteriori informazioni, consulta [Esegui un contenitore Docker](run-docker-container.md).
**Nota**  
Se non specifichi il tag dell'immagine o l'image digest nell'URI dell'artefatto per un'immagine, il gestore delle applicazioni Docker recupera l'ultima versione disponibile di quell'immagine quando distribuisci il componente contenitore Docker personalizzato. Per garantire che tutti i dispositivi principali eseguano la stessa versione di un'immagine, ti consigliamo di includere il tag dell'immagine o l'image digest nell'URI dell'artefatto.
+ <a name="docker-user-permissions-requirement"></a>L'utente di sistema che esegue un componente del contenitore Docker deve disporre delle autorizzazioni di root o amministratore oppure è necessario configurare Docker per eseguirlo come utente non root o non amministratore.
  + Sui dispositivi Linux, puoi aggiungere un utente al gruppo senza il quale chiamare i comandi. `docker` `docker` `sudo`
  + Nei dispositivi Windows, è possibile aggiungere un utente al `docker-users` gruppo per richiamare `docker` comandi senza privilegi di amministratore.

------
#### [ Linux or Unix ]

  Per aggiungere `ggc_user` al `docker` gruppo l'utente non root che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente.

  ```
  sudo usermod -aG docker ggc_user
  ```

  Per ulteriori informazioni, consulta [Gestire Docker come](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) utente non root.

------
#### [ Windows Command Prompt (CMD) ]

  Per aggiungere al `docker-users` gruppo`ggc_user`, o l'utente che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente come amministratore.

  ```
  net localgroup docker-users ggc_user /add
  ```

------
#### [ Windows PowerShell ]

  Per aggiungere al `docker-users` gruppo`ggc_user`, o l'utente che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente come amministratore.

  ```
  Add-LocalGroupMember -Group docker-users -Member ggc_user
  ```

------
+ <a name="docker-proxy-requirement"></a>Se [configuri il software AWS IoT Greengrass Core per utilizzare un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy), devi [configurare Docker per utilizzare lo stesso server proxy](https://docs.docker.com/network/proxy/).
+ Se le tue immagini Docker sono archiviate in un registro privato Amazon ECR, devi includere il componente del servizio di scambio di token come dipendenza nel componente contenitore Docker. Inoltre, il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire le `ecr:GetDownloadUrlForLayer` azioni`ecr:GetAuthorizationToken`, e`ecr:BatchGetImage`, come mostrato nell'esempio seguente di politica IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "ecr:GetAuthorizationToken",
          "ecr:BatchGetImage",
          "ecr:GetDownloadUrlForLayer"
        ],
        "Resource": [
          "*"
        ],
        "Effect": "Allow"
      }
    ]
  }
  ```

------

  ```
  ```
+ Il componente docker application manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente docker application manager deve disporre di connettività per scaricare le immagini. Ad esempio, se si utilizza ECR, è necessario disporre della connettività ai seguenti endpoint.
    + `*.dkr.ecr.region.amazonaws.com`(endpoint VPC) `com.amazonaws.region.ecr.dkr`
    + `api.ecr.region.amazonaws.com`(endpoint VPC) `com.amazonaws.region.ecr.api`

### Endpoint e porte
<a name="docker-application-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `ecr.region.amazonaws.com`  | 443 | No |  Obbligatorio se scarichi immagini Docker da Amazon ECR.  | 
|  `hub.docker.com` `registry.hub.docker.com/v1`  | 443 | No |  Obbligatorio se scarichi immagini Docker da Docker Hub.  | 

## Dipendenze
<a name="docker-application-manager-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#docker-application-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.0.15 ]

La tabella seguente elenca le dipendenze per la versione 2.0.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Flessibili | 

------
#### [ 2.0.14 ]

La tabella seguente elenca le dipendenze per la versione 2.0.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Flessibili | 

------
#### [ 2.0.13 ]

La tabella seguente elenca le dipendenze per la versione 2.0.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Flessibili | 

------
#### [ 2.0.12 ]

La tabella seguente elenca le dipendenze per la versione 2.0.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Flessibili | 

------
#### [ 2.0.11 ]

La tabella seguente elenca le dipendenze per la versione 2.0.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Flessibili | 

------
#### [ 2.0.10 ]

La tabella seguente elenca le dipendenze per la versione 2.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Flessibili | 

------
#### [ 2.0.9 ]

La tabella seguente elenca le dipendenze per la versione 2.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Flessibili | 

------
#### [ 2.0.8 ]

La tabella seguente elenca le dipendenze per la versione 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Flessibili | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Flessibili | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Flessibili | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Flessibili | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Flessibili | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flessibili | 

------
#### [ 2.0.2 ]

La tabella seguente elenca le dipendenze per la versione 2.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flessibili | 

------
#### [ 2.0.1 ]

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flessibili | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="docker-application-manager-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="docker-application-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="docker-application-manager-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|   **Versione**   |   **Modifiche**   | 
| --- | --- | 
|  2.0.15  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.0.14  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.0.13  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.0.12  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.0.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.0.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.0.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.0.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.0.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.0.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.0  |  Versione iniziale.  | 

## Consulta anche
<a name="docker-application-manager-component-see-also"></a>
+  [Esegui un contenitore Docker](run-docker-container.md) 

# Connettore Edge per Kinesis Video Streams
<a name="kvs-edge-connector-component"></a>

Il connettore perimetrale per il `aws.iot.EdgeConnectorForKVS` componente Kinesis Video Streams () legge i feed video dalle telecamere locali e li pubblica su Kinesis Video Streams. È possibile configurare questo componente per leggere i feed video dalle telecamere IP (Internet Protocol) utilizzando il protocollo RTSP (Real Time Streaming Protocol). Quindi, puoi configurare dashboard in [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) o server Grafana locali per monitorare e interagire con i flussi video.

Puoi integrare questo componente con AWS IoT TwinMaker per visualizzare e controllare i flussi video nelle dashboard Grafana. AWS IoT TwinMaker è un AWS servizio che consente di creare gemelli digitali operativi di sistemi fisici. È possibile utilizzarlo AWS IoT TwinMaker per visualizzare i dati provenienti da sensori, fotocamere e applicazioni aziendali per monitorare le fabbriche fisiche, gli edifici o gli impianti industriali. È inoltre possibile utilizzare questi dati per monitorare le operazioni, diagnosticare errori e correggere errori. Per ulteriori informazioni, consulta [Cos'è AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) nella *Guida AWS IoT TwinMaker per l'utente*.

Questo componente memorizza la sua configurazione in AWS IoT SiteWise, un AWS servizio che modella e archivia i dati industriali. In AWS IoT SiteWise, *le risorse* rappresentano oggetti come dispositivi, apparecchiature o gruppi di altri oggetti. Per configurare e utilizzare questo componente, crei una AWS IoT SiteWise risorsa per ogni dispositivo principale Greengrass e per ogni telecamera IP collegata a ciascun dispositivo principale. Ogni risorsa ha proprietà configurabili per controllare funzionalità come lo streaming live, il caricamento su richiesta e la memorizzazione nella cache locale. Per specificare l'URL di ogni telecamera, create un indirizzo segreto Gestione dei segreti AWS che contiene l'URL della videocamera. Se la fotocamera richiede l'autenticazione, specificate anche un nome utente e una password nell'URL. Quindi, specificate quel segreto in una proprietà della risorsa per la telecamera IP.

Questo componente carica il flusso video di ogni telecamera su un flusso video Kinesis. È necessario specificare il nome del flusso video Kinesis di destinazione nella configurazione degli AWS IoT SiteWise asset per ogni telecamera. Se lo stream video Kinesis non esiste, questo componente lo crea automaticamente.

AWS IoT TwinMaker fornisce uno script che è possibile eseguire per creare queste AWS IoT SiteWise risorse e i segreti di Secrets Manager. Per ulteriori informazioni su come creare queste risorse e su come installare, configurare e utilizzare questo componente, consultate [l'integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida per l'AWS IoT TwinMaker utente*.

**Nota**  
Il connettore perimetrale per il componente Kinesis Video Streams è disponibile solo nei seguenti casi: Regioni AWS  
Stati Uniti orientali (Virginia settentrionale)
Stati Uniti occidentali (Oregon)
Europa (Francoforte)
Europa (Irlanda)
Asia Pacifico (Singapore)
Asia Pacifico (Tokyo)
Asia Pacifico (Seul)
Asia Pacifico (Sydney)
Asia Pacifico (Mumbai)
Cina (Pechino)

**Topics**
+ [Versioni](#kvs-edge-connector-component-versions)
+ [Tipo](#kvs-edge-connector-component-type)
+ [Sistema operativo](#kvs-edge-connector-component-os-support)
+ [Requisiti](#kvs-edge-connector-component-requirements)
+ [Dipendenze](#kvs-edge-connector-component-dependencies)
+ [Configurazione](#kvs-edge-connector-component-configuration)
+ [Licenze](#kvs-edge-connector-component-licenses)
+ [Utilizzo](#kvs-edge-connector-component-usage)
+ [File di registro locale](#kvs-edge-connector-component-log-file)
+ [Changelog](#kvs-edge-connector-component-changelog)
+ [Consulta anche](#kvs-edge-connector-component-see-also)

## Versioni
<a name="kvs-edge-connector-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.0.x

## Tipo
<a name="kvs-edge-connector-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="kvs-edge-connector-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="kvs-edge-connector-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ È possibile distribuire questo componente solo su dispositivi single-core, poiché la configurazione del componente deve essere unica per ogni dispositivo principale. Non puoi distribuire questo componente su gruppi di dispositivi principali.
+ [GStreamer](https://gstreamer.freedesktop.org)1.18.4 o versione successiva installata sul dispositivo principale. [Per ulteriori informazioni, vedere Installazione. GStreamer](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c)

  Su un dispositivo con`apt`, puoi eseguire i seguenti comandi per l'installazione GStreamer.

  ```
  sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps
  sudo apt install -y gstreamer1.0-libav
  sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools
  ```
+ Una AWS IoT SiteWise risorsa per ogni dispositivo principale. Questa AWS IoT SiteWise risorsa rappresenta il dispositivo principale. Per ulteriori informazioni su come creare questa risorsa, consultate [l'integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida per l'AWS IoT TwinMaker utente*.
+ Una AWS IoT SiteWise risorsa per ogni telecamera IP collegata a ciascun dispositivo principale. Queste AWS IoT SiteWise risorse rappresentano le telecamere che trasmettono video a ciascun dispositivo principale. La risorsa di ogni videocamera deve essere associata alla risorsa per il dispositivo principale che si collega alla videocamera. Le risorse della videocamera hanno proprietà che puoi configurare per specificare un flusso video Kinesis, un segreto di autenticazione e parametri di streaming video. Per ulteriori informazioni su come creare e configurare le risorse della videocamera, consulta [l'integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida per l'AWS IoT TwinMaker utente*.
+ Un Gestione dei segreti AWS segreto per ogni telecamera IP. Questo segreto deve definire una coppia chiave-valore, dove si trova la chiave e il valore è l'URL della telecamera. `RTSPStreamUrl` Se la fotocamera richiede l'autenticazione, includi il nome utente e la password in questo URL. È possibile utilizzare uno script per creare un segreto quando si creano le risorse richieste da questo componente. Per ulteriori informazioni, consulta [l'integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida AWS IoT TwinMaker per l'utente*.

  Puoi anche utilizzare la console e l'API di Secrets Manager per creare segreti aggiuntivi. Per ulteriori informazioni, consulta [Creare un segreto](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella *Guida Gestione dei segreti AWS per l'utente*.
+ Il [ruolo di scambio di token Greengrass](device-service-role.md) deve consentire le seguenti azioni e quelle di Kinesis Video Streams Gestione dei segreti AWS AWS IoT SiteWise, come illustrato nell'esempio seguente di policy IAM.
**Nota**  
Questa policy di esempio consente al dispositivo di ottenere il valore dei segreti denominati and. **IPCamera1Url** **IPCamera2Url** Quando si configura ogni telecamera IP, si specifica un segreto che contiene l'URL di quella telecamera. Se la telecamera richiede l'autenticazione, si specificano anche un nome utente e una password nell'URL. Il ruolo di scambio di token del dispositivo principale deve consentire l'accesso al segreto per ogni telecamera IP da connettere.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "secretsmanager:GetSecretValue"
        ],
        "Effect": "Allow",
        "Resource": [
        "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url",
    "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url"
        ]
      },
      {
        "Action": [
          "iotsitewise:BatchPutAssetPropertyValue",
          "iotsitewise:DescribeAsset",
          "iotsitewise:DescribeAssetModel",
          "iotsitewise:DescribeAssetProperty",
          "iotsitewise:GetAssetPropertyValue",
          "iotsitewise:ListAssetRelationships",
          "iotsitewise:ListAssets",
          "iotsitewise:ListAssociatedAssets",
          "kinesisvideo:CreateStream",
          "kinesisvideo:DescribeStream",
          "kinesisvideo:GetDataEndpoint",
          "kinesisvideo:PutMedia",
          "kinesisvideo:TagStream"
        ],
        "Effect": "Allow",
        "Resource": [
          "*"
        ]
      }
    ]
  }
  ```

------
**Nota**  
Se si utilizza una AWS Key Management Service chiave gestita dal cliente per crittografare i segreti, anche il ruolo del dispositivo deve consentire l'`kms:Decrypt`azione.

### Endpoint e porte
<a name="kvs-edge-connector-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `kinesisvideo.region.amazonaws.com`  | 443 | Sì |  Carica i dati su Kinesis Video Streams.  | 
|  `data.iotsitewise.region.amazonaws.com`  | 443 | Sì |  Pubblica i metadati dei flussi video su. AWS IoT SiteWise  | 
|  `secretsmanager.region.amazonaws.com`  | 443 | Sì |  Scarica i segreti degli URL della fotocamera sul dispositivo principale.  | 

## Dipendenze
<a name="kvs-edge-connector-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#kvs-edge-connector-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per le versioni da 1.0.0 a 1.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.3 | Rigidi | 
| [Gestore di stream](stream-manager-component.md) | >=2.0.9 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="kvs-edge-connector-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`SiteWiseAssetIdForHub`  
L'ID della AWS IoT SiteWise risorsa che rappresenta questo dispositivo principale. Per ulteriori informazioni su come creare questa risorsa e utilizzarla per interagire con questo componente, consultate [l'integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida per l'AWS IoT TwinMaker utente*.

**Example Esempio: fusione e aggiornamento della configurazione**  

```
{
  "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```

## Licenze
<a name="kvs-edge-connector-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:
+ [Quartz Job Scheduler/ Licenza](http://www.quartz-scheduler.org/) Apache 2.0
+ [Collegamenti Java per GStreamer 1.x /GNU](https://github.com/gstreamer-java/gst1-java-core) Lesser General Public License v3.0

## Utilizzo
<a name="kvs-edge-connector-component-usage"></a>

Per configurare e interagire con questo componente, potete impostare le proprietà AWS IoT SiteWise degli asset che rappresentano il dispositivo principale e le telecamere IP a cui si connette. Puoi anche visualizzare e interagire con i flussi video nelle dashboard di Grafana tramite. AWS IoT TwinMaker *Per ulteriori informazioni, consulta l'[integrazione AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella Guida per l'utente.AWS IoT TwinMaker *

## File di registro locale
<a name="kvs-edge-connector-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
  ```

## Changelog
<a name="kvs-edge-connector-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.0.5  |  Correzioni di bug generali e miglioramenti.  | 
|  1.0.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/kvs-edge-connector-component.html)  | 
|  1.0.3  |  Correzioni di bug generali e miglioramenti.  | 
|  1.0.1  |  Correzioni di bug generali e miglioramenti.  | 
|  1.0.0  |  Versione iniziale.  | 

## Consulta anche
<a name="kvs-edge-connector-component-see-also"></a>
+ [Che cos'è? AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) nella *Guida per l'AWS IoT TwinMaker utente*
+ [AWS IoT TwinMaker integrazione video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) nella *Guida per l'AWS IoT TwinMaker utente*
+ [Che cos'è AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) nella *Guida per l'AWS IoT SiteWise utente*
+ [Aggiornamento dei valori degli attributi](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html) nella *Guida AWS IoT SiteWise per l'utente*
+ [Cos'è Gestione dei segreti AWS?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) nella *Guida per l'utente di Gestione dei segreti AWS *
+ [Crea e gestisci segreti](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html) nella *Guida Gestione dei segreti AWS per l'utente*

# Greengrass CLI
<a name="greengrass-cli-component"></a>

Il componente Greengrass CLI (`aws.greengrass.Cli`) fornisce un'interfaccia a riga di comando locale che è possibile utilizzare sui dispositivi principali per sviluppare ed eseguire il debug dei componenti localmente. La CLI Greengrass consente, ad esempio, di creare distribuzioni locali e riavviare i componenti sul dispositivo principale.

È possibile installare questo componente quando si installa il software Core. AWS IoT Greengrass Per ulteriori informazioni, consulta [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md).

**Importante**  
 <a name="local-dev-tools-production-environment-warning"></a>Si consiglia di utilizzare questo componente solo in ambienti di sviluppo, non in ambienti di produzione. Questo componente fornisce l'accesso a informazioni e operazioni che in genere non sono necessarie in un ambiente di produzione. Segui il principio del privilegio minimo distribuendo questo componente solo sui dispositivi principali dove ne hai bisogno. 

Dopo aver installato questo componente, esegui il comando seguente per visualizzarne la documentazione di aiuto. Quando questo componente viene installato, aggiunge un collegamento simbolico alla `greengrass-cli` `/greengrass/v2/bin` cartella. È possibile eseguire la CLI Greengrass da questo percorso o aggiungerla alla variabile di `PATH` ambiente per eseguirla `greengrass-cli` senza il percorso assoluto.

------
#### [ Linux or Unix ]

```
/greengrass/v2/bin/greengrass-cli help
```

------
#### [ Windows ]

```
C:\greengrass\v2\bin\greengrass-cli help
```

------

Il comando seguente riavvia un componente denominato`com.example.HelloWorld`, ad esempio.

------
#### [ Linux or Unix ]

```
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
```

------
#### [ Windows ]

```
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"
```

------

Per ulteriori informazioni, consulta [Interfaccia a riga di comando Greengrass](gg-cli.md).

**Topics**
+ [Versioni](#greengrass-cli-component-versions)
+ [Tipo](#greengrass-cli-component-type)
+ [Sistema operativo](#greengrass-cli-component-os-support)
+ [Requisiti](#greengrass-cli-component-requirements)
+ [Dipendenze](#greengrass-cli-component-dependencies)
+ [Configurazione](#greengrass-cli-component-configuration)
+ [File di registro locale](#greengrass-cli-component-log-file)
+ [Changelog](#greengrass-cli-component-changelog)

## Versioni
<a name="greengrass-cli-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.16.x
+ 2.15x
+ 2.14x
+ 2.13x
+ 2.12x
+ 2.11. x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2,5. x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="greengrass-cli-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="greengrass-cli-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="greengrass-cli-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ <a name="greengrass-cli-authorization-requirement"></a>È necessario essere autorizzati a utilizzare la CLI Greengrass per interagire con il software Core. AWS IoT Greengrass Effettuate una delle seguenti operazioni per utilizzare la Greengrass CLI:
  + Utilizzate l'utente di sistema che esegue il software AWS IoT Greengrass Core.
  + Usa un utente con autorizzazioni root o amministrative. Sui dispositivi principali di Linux, puoi utilizzarlo per ottenere i permessi `sudo` di root.
  + Usa un utente di sistema che fa parte di un gruppo specificato nei parametri di `AuthorizedWindowsGroups` configurazione `AuthorizedPosixGroups` o quando distribuisci il componente. Per ulteriori informazioni, consulta Configurazione dei componenti della [CLI di Greengrass](#greengrass-cli-component-configuration).
+ Il componente Greengrass CLI è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="greengrass-cli-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#greengrass-cli-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.16.0 ]

La tabella seguente elenca le dipendenze per la versione 2.16.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Flessibili | 

------
#### [ 2.15.1 ]

La tabella seguente elenca le dipendenze per la versione 2.15.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flessibili | 

------
#### [ 2.15.0 ]

La tabella seguente elenca le dipendenze per la versione 2.15.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flessibili | 

------
#### [ 2.14.0 – 2.14.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.14.0 e 2.14.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Flessibili | 

------
#### [ 2.13.0 ]

La tabella seguente elenca le dipendenze per la versione 2.13.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Flessibili | 

------
#### [ 2.12.0 – 2.12.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.12.0 a 2.12.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Flessibili | 

------
#### [ 2.11.0 – 2.11.3 ]

La tabella seguente elenca le dipendenze per le versioni da 2.11.0 a 2.11.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Flessibili | 

------
#### [ 2.10.0 – 2.10.3 ]

La tabella seguente elenca le dipendenze per le versioni da 2.10.0 a 2.10.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flessibili | 

------
#### [ 2.9.0 – 2.9.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.9.0 a 2.9.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flessibili | 

------
#### [ 2.8.0 – 2.8.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.8.0 e 2.8.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Flessibili | 

------
#### [ 2.7.0 ]

La tabella seguente elenca le dipendenze per la versione 2.7.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Flessibili | 

------
#### [ 2.6.0 ]

La tabella seguente elenca le dipendenze per la versione 2.6.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Flessibili | 

------
#### [ 2.5.0 – 2.5.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.5.0 a 2.5.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Flessibili | 

------
#### [ 2.4.0 ]

La tabella seguente elenca le dipendenze per la versione 2.4.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flessibili | 

------
#### [ 2.3.0 ]

La tabella seguente elenca le dipendenze per la versione 2.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Flessibili | 

**Nota**  
La versione minima compatibile del nucleo Greengrass corrisponde alla versione patch del componente Greengrass CLI. 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="greengrass-cli-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.5.x - 2.14.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come `sudo` utente root () o come utente di sistema che AWS IoT Greengrass esegue il software Core.

`AuthorizedWindowsGroups`  <a name="greengrass-cli-component-configuration-authorizedwindowsgroups"></a>
(Facoltativo) Una stringa che contiene un elenco separato da virgole di gruppi di sistema. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come amministratore o come utente di sistema che AWS IoT Greengrass esegue il software Core.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di autorizzare tre gruppi di sistema POSIX (`group1``1002`, e`group3`) e due gruppi di utenti Windows (`Device Operators`and`QA Engineers`) a utilizzare la Greengrass CLI.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
```

------
#### [ 2.4.x - 2.0.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come `sudo` utente root () o come utente di sistema che AWS IoT Greengrass esegue il software Core.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di autorizzare tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la Greengrass CLI.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3"
}
```

------

## File di registro locale
<a name="greengrass-cli-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="greengrass-cli-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.16.1  |  Versione aggiornata per la versione 2.16.1 di Greengrass nucleus.  | 
|  2.16.0  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.15.1  |  Versione aggiornata per la versione 2.15.1 di Greengrass nucleus.  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.14.3  |  Versione aggiornata per la versione 2.14.3 di Greengrass nucleus.  | 
|  2.14.2  |  Versione aggiornata per la versione 2.14.2 di Greengrass nucleus.  | 
|  2.14.1  |  Versione aggiornata per la versione 2.14.1 di Greengrass nucleus.  | 
|  2.14.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.13.0  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.  | 
|  2.12.6  |  Versione aggiornata per la versione 2.12.6 di Greengrass nucleus.  | 
|  2.12.5  |  Versione aggiornata per la versione 2.12.5 di Greengrass nucleus.  | 
|  2.12.4  |  Versione aggiornata per la versione 2.12.4 di Greengrass nucleus.  | 
|  2.12.3  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  Versione aggiornata per la versione 2.12.3 di Greengrass nucleus.  | 
|  2.12.2  |  Versione aggiornata per la versione 2.12.2 di Greengrass nucleus.  | 
|  2.12.1  |  Versione aggiornata per la versione 2.12.1 di Greengrass nucleus.  | 
|  2.12.0  |  Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.  | 
|  2.11.3  |  Versione aggiornata per la versione 2.11.3 di Greengrass nucleus.  | 
|  2.11.2  |  Versione aggiornata per la versione 2.11.2 di Greengrass nucleus.  | 
|  2.11.1  |  Versione aggiornata per la versione 2.11.1 di Greengrass nucleus.  | 
|  2.11.0  |  <a name="changelog-cli-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.10.3  |  Versione aggiornata per la versione 2.10.3 di Greengrass nucleus.  | 
|  2.10.2  |  Versione aggiornata per la versione 2.10.2 di Greengrass nucleus.  | 
|  2.10.1  |  Versione aggiornata per la versione 2.10.1 di Greengrass nucleus.  | 
|  2.10.0  |  Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.  | 
|  2.9.6  |  Versione aggiornata per la versione 2.9.6 di Greengrass nucleus.  | 
|  2.9.5  |  Versione aggiornata per la versione 2.9.5 di Greengrass nucleus.  | 
|  2.9.4  |  Versione aggiornata per la versione 2.9.4 di Greengrass nucleus.  | 
|  2.9.3  |  Versione aggiornata per la versione 2.9.3 di Greengrass nucleus.  | 
|  2.9.2  |  Versione aggiornata per la versione 2.9.2 di Greengrass nucleus.  | 
|  2.9.1  |  Versione aggiornata per la versione 2.9.1 di Greengrass nucleus.  | 
|  2.9.0  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.8.1  |  Versione aggiornata per la versione 2.8.1 di Greengrass nucleus.  | 
|  2.8.0  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.7.0  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.6.0  |  <a name="changelog-greengrass-cli-2.6.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.5.6  |  Versione aggiornata per la versione 2.5.6 di Greengrass nucleus.  | 
|  2.5.5  |  Versione aggiornata per la versione 2.5.5 di Greengrass nucleus.  | 
|  2.5.4  |  Versione aggiornata per la versione 2.5.4 di Greengrass nucleus.  | 
|  2.5.3  |  Versione aggiornata per la versione 2.5.3 di Greengrass nucleus.  | 
|  2.5.2  |  Versione aggiornata per la versione 2.5.2 di Greengrass nucleus.  | 
|  2.5.1  |  Versione aggiornata per la versione 2.5.1 di Greengrass nucleus.  | 
|  2.5.0  |  <a name="changelog-greengrass-cli-2.5.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.4.0  |  <a name="changelog-greengrass-cli-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.3.0  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.2.0  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.5  | Versione aggiornata per la versione 2.0.5 di Greengrass nucleus. | 
|  2.0.4  | Versione aggiornata per la versione 2.0.4 di Greengrass nucleus. | 
|  2.0.3  |  Versione iniziale.  | 

# Rilevatore IP
<a name="ip-detector-component"></a>

Il componente del rilevatore IP (`aws.greengrass.clientdevices.IPDetector`) esegue le seguenti operazioni:
+ Monitora le informazioni sulla connettività di rete del dispositivo principale Greengrass. Queste informazioni includono gli endpoint di rete del dispositivo principale e la porta su cui opera un broker MQTT.
+ Aggiorna le informazioni di connettività del dispositivo principale nel AWS IoT Greengrass servizio cloud.

I dispositivi client possono utilizzare Greengrass cloud discovery per recuperare le informazioni di connettività dei dispositivi principali associati. Quindi, i dispositivi client possono provare a connettersi a ciascun dispositivo principale fino a quando non si connettono correttamente.

**Nota**  <a name="client-device-component-context"></a>
I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta [Interagisci con dispositivi IoT locali](interact-with-local-iot-devices.md).

Il componente del rilevatore IP sostituisce le informazioni di connettività esistenti di un dispositivo principale con le informazioni rilevate. Poiché questo componente rimuove le informazioni esistenti, è possibile utilizzare il componente del rilevatore IP o gestire manualmente le informazioni di connettività.

**Topics**
+ [Versioni](#ip-detector-component-versions)
+ [Tipo](#ip-detector-component-type)
+ [Sistema operativo](#ip-detector-component-os-support)
+ [Requisiti](#ip-detector-component-requirements)
+ [Dipendenze](#ip-detector-component-dependencies)
+ [Configurazione](#ip-detector-component-configuration)
+ [File di registro locale](#ip-detector-component-log-file)
+ [Changelog](#ip-detector-component-changelog)

## Versioni
<a name="ip-detector-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="ip-detector-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="ip-detector-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="ip-detector-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il [ruolo del servizio Greengrass](greengrass-service-role.md) deve essere associato al tuo Account AWS e consentire le autorizzazioni `iot:GetThingShadow` e`iot:UpdateThingShadow`.
+ La AWS IoT politica del dispositivo principale deve consentire l'`greengrass:UpdateConnectivityInfo`autorizzazione. Per ulteriori informazioni, consultare [AWS IoT politiche per le operazioni sul piano dati](device-auth.md#iot-policies) e [AWS IoT Politica minima per il supporto dei dispositivi client](device-auth.md#client-device-support-minimal-iot-policy).
+ Se si configura il componente broker MQTT del dispositivo principale per utilizzare una porta diversa dalla porta predefinita 8883, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta in cui opera il broker.
+ Se disponi di una configurazione di rete complessa, il componente del rilevatore IP potrebbe non essere in grado di identificare gli endpoint in cui i dispositivi client possono connettersi al dispositivo principale. Se il componente del rilevatore IP non è in grado di gestire gli endpoint, devi invece gestire manualmente gli endpoint principali del dispositivo. Ad esempio, se il dispositivo principale si trova dietro un router che gli inoltra la porta del broker MQTT, è necessario specificare l'indirizzo IP del router come endpoint per il dispositivo principale. Per ulteriori informazioni, consulta [Gestisci gli endpoint principali dei dispositivi](manage-core-device-endpoints.md).
+ Il componente del rilevatore IP è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="ip-detector-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#ip-detector-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.2.3 ]

La tabella seguente elenca le dipendenze per la versione 2.2.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.17.0 | Flessibili | 

------
#### [ 2.2.2 ]

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.16.0 | Flessibili | 

------
#### [ 2.2.1 ]

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.15.0 | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.14.0 | Flessibili | 

------
#### [ 2.1.8 – 2.1.9 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.8 e 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.0 and 2.0.2 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.0 e 2.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Flessibili | 

------
#### [ 2.0.1 ]

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Flessibili | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="ip-detector-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.2.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(Facoltativo) La porta del broker MQTT da segnalare quando questo componente rileva gli indirizzi IP. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883.  
Impostazione predefinita: `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv4 loopback. Si tratta di indirizzi IP, ad esempio quelli `localhost` in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.  
Impostazione predefinita: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv4 [locali dei collegamenti](https://en.wikipedia.org/wiki/Link-local_address). Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente.  
Impostazione predefinita: `false`

`includeIPv6LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv6 loopback. Si tratta di indirizzi IP, ad esempio quelli `localhost` in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema. È necessario `includeIPv4Addrs` impostare `false` e `includeIPv6Addrs` `true` utilizzare questa opzione.  
Impostazione predefinita: `false`

`includeIPv6LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv6 [locali del collegamento](https://en.wikipedia.org/wiki/Link-local_address). Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente. È necessario `includeIPv4Addrs` impostare `false` e `includeIPv6Addrs` `true` utilizzare questa opzione.  
Impostazione predefinita: `false`

`includeIPv4Addrs`  <a name="ip-detector-component-configuration-include-ipv4-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Facoltativo) L'impostazione predefinita è impostata su`true`. È possibile abilitare questa opzione per pubblicare IPv4 gli indirizzi trovati sul dispositivo principale.  
Impostazione predefinita: `true`

`includeIPv6Addrs`  <a name="ip-detector-component-configuration-include-ipv6-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per pubblicare IPv6 gli indirizzi trovati sul dispositivo principale. Imposta `includeIPv4Addrs` `false` per utilizzare questa opzione.  
Impostazione predefinita: `false`

------
#### [ 2.1.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(Facoltativo) La porta del broker MQTT da segnalare quando questo componente rileva gli indirizzi IP. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883.  
Impostazione predefinita: `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv4 loopback. Si tratta di indirizzi IP, ad esempio quelli `localhost` in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.  
Impostazione predefinita: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv4 [locali dei collegamenti](https://en.wikipedia.org/wiki/Link-local_address). Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente.  
Impostazione predefinita: `false`

------
#### [ 2.0.x ]

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv4 loopback. Si tratta di indirizzi IP, ad esempio quelli `localhost` in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.  
Impostazione predefinita: `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv4 [locali dei collegamenti](https://en.wikipedia.org/wiki/Link-local_address). Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente.  
Impostazione predefinita: `false`

------

## File di registro locale
<a name="ip-detector-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="ip-detector-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.2.3  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.2.2  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.2.1  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.2.0  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.9  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.8  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.6  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.5  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.4  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.3  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.1  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.0.2  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.1  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.0  |  Versione iniziale.  | 

# Firehose
<a name="kinesis-firehose-component"></a>

Il componente Firehose (`aws.greengrass.KinesisFirehose`) pubblica i dati tramite i flussi di distribuzione di Amazon Data Firehose verso destinazioni come Amazon S3, Amazon Redshift e Amazon Service. OpenSearch Per ulteriori informazioni, consulta [What is Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html)? nella *Amazon Data Firehose Developer Guide*.

Per pubblicare su un flusso di distribuzione Kinesis con questo componente, pubblica un messaggio su un argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente sottoscrive gli argomenti di `kinesisfirehose/message` pubblicazione/sottoscrizione `kinesisfirehose/message/binary/#` [locali](ipc-publish-subscribe.md). È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

**Nota**  
Questo componente offre funzionalità simili al connettore Firehose della versione 1. AWS IoT Greengrass Per ulteriori informazioni, consulta il [connettore Firehose](https://docs.aws.amazon.com/greengrass/latest/developerguide/kinesis-firehose-connector.html) nella *AWS IoT Greengrass V1* Developer Guide.

**Topics**
+ [Versioni](#kinesis-firehose-component-versions)
+ [Tipo](#kinesis-firehose-component-type)
+ [Sistema operativo](#kinesis-firehose-component-os-support)
+ [Requisiti](#kinesis-firehose-component-requirements)
+ [Dipendenze](#kinesis-firehose-component-dependencies)
+ [Configurazione](#kinesis-firehose-component-configuration)
+ [Dati di input](#kinesis-firehose-component-input-data)
+ [Dati di output](#kinesis-firehose-component-output-data)
+ [File di registro locale](#kinesis-firehose-component-log-file)
+ [Licenze](#kinesis-firehose-component-licenses)
+ [Changelog](#kinesis-firehose-component-changelog)
+ [Consulta anche](#kinesis-firehose-component-see-also)

## Versioni
<a name="kinesis-firehose-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="kinesis-firehose-component-type"></a>

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a>componente è un componente Lambda () `aws.greengrass.lambda`. [Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.](lambda-launcher-component.md)

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="kinesis-firehose-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="kinesis-firehose-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire le `firehose:PutRecordBatch` azioni `firehose:PutRecord` and, come illustrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "firehose:PutRecord",
          "firehose:PutRecordBatch"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:firehose:us-east-1:123456789012:deliverystream/stream-name"
        ]
      }
    ]
  }
  ```

------

  È possibile sovrascrivere dinamicamente il flusso di consegna predefinito nel payload del messaggio di input per questo componente. Se l'applicazione utilizza questa funzionalità, la policy IAM deve includere tutti i flussi di destinazione come risorse. Puoi concedere alle risorse un accesso granulare o condizionale (ad esempio, utilizzando uno schema di denominazione con il carattere jolly `*`).
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il [componente legacy del router di abbonamento](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-kinesisfirehose": {
        "id": "aws-greengrass-kinesisfirehose",
        "source": "component:aws.greengrass.KinesisFirehose",
        "subject": "kinesisfirehose/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-kinesisfirehose": {
        "id": "aws-greengrass-kinesisfirehose",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-kinesisfirehose:version",
        "subject": "kinesisfirehose/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sostituiscilo con quello Regione AWS che usi.
  + Sostituisci *version* con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass) e cerca la coppia chiave-valore della **funzione Lambda**. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di sottoscrizione legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).
+ Il componente Firehose è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente Firehose deve disporre di una connettività a `firehose.region.amazonaws.com` cui l'endpoint VPC sia di. `com.amazonaws.region.kinesis-firehose`

### Endpoint e porte
<a name="kinesis-firehose-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `firehose.region.amazonaws.com`  | 443 | Sì |  Caricare i dati su Firehose.  | 

## Dipendenze
<a name="kinesis-firehose-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#kinesis-firehose-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.8 e 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | >=1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="kinesis-firehose-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`DEFAULT_DELIVERY_STREAM_ARN`  
L'ARN del flusso di distribuzione Firehose predefinito a cui il componente invia i dati. È possibile sovrascrivere lo stream di destinazione con la `delivery_stream_arn` proprietà nel payload del messaggio di input.  
Il ruolo principale del dispositivo deve consentire le azioni richieste su tutti i flussi di consegna di destinazione. Per ulteriori informazioni, consulta [Requisiti](#kinesis-firehose-component-requirements).  
`PUBLISH_INTERVAL`  
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi dati in batch su Firehose. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, vale a dire senza raggruppamento in batch, specificate. `0`  
Questo valore può essere al massimo di 900 secondi.  
Impostazione predefinita: 10 secondi  
`DELIVERY_STREAM_QUEUE_SIZE`  
(Facoltativo) Il numero massimo di record da conservare in memoria prima che il componente rifiuti nuovi record per lo stesso flusso di distribuzione.  
Questo valore deve essere almeno 2.000 record.  
Impostazione predefinita: 5.000 record

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 64 MB (65.535 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente sottoscrive la sottoscrizione per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`and`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
    }
  },
  "containerMode": "NoContainer"
}
```

## Dati di input
<a name="kinesis-firehose-component-input-data"></a>

Questo componente accetta contenuti in streaming sui seguenti argomenti e li invia al flusso di consegna di destinazione. Il componente accetta due tipi di dati di input:
+ Dati JSON nell'argomento `kinesisfirehose/message`.
+ Dati binari nell'argomento `kinesisfirehose/message/binary/#`.

**Argomento predefinito per i dati JSON (pubblicazione locale/sottoscrizione):** `kinesisfirehose/message`  
<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.    
`request`  
I dati da inviare al flusso di distribuzione e al flusso di distribuzione di destinazione, se diverso da quello predefinito.  
Tipo: `object` che contiene le seguenti informazioni:    
`data`  
I dati da inviare al flusso di distribuzione.  
Tipo: `string`  
`delivery_stream_arn`  
(Facoltativo) L'ARN del flusso di distribuzione Firehose di destinazione. Specificate questa proprietà per sovrascrivere il flusso di consegna predefinito.  
Tipo: `string`  
`id`  <a name="connector-component-input-property-id"></a>
Un ID arbitrario della richiesta. Utilizzate questa proprietà per mappare una richiesta di input a una risposta di output. Quando specificate questa proprietà, il componente imposta la `id` proprietà nell'oggetto di risposta su questo valore.  
Tipo: `string`

**Example Input di esempio**  

```
{
  "request": {
    "delivery_stream_arn": "arn:aws:firehose:region:account-id:deliverystream/stream2-name",
    "data": "Data to send to the delivery stream."
  },
  "id": "request123"
}
```

**Argomento predefinito per i dati binari (pubblicazione locale/sottoscrizione):** `kinesisfirehose/message/binary/#`  
Utilizzare questo argomento per inviare un messaggio contenente dati binari. Il componente non analizza i dati binari. Il componente trasmette i dati così come sono.  
Per associare la richiesta di input a una risposta di output, sostituisci il carattere jolly `#` nell'argomento del messaggio con un ID richiesta arbitrario. Ad esempio, se pubblichi un messaggio in `kinesisfirehose/message/binary/request123`, la proprietà `id` nell'oggetto di risposta viene impostata su `request123`.  
Se non desideri associare una richiesta a una risposta, puoi pubblicare i messaggi in `kinesisfirehose/message/binary/`. Assicurati di includere la barra finale (). `/`

## Dati di output
<a name="kinesis-firehose-component-output-data"></a>

 <a name="connector-component-output-data"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come contenuto `subject` nella configurazione del componente [legacy del router di abbonamento](legacy-subscription-router-component.md). Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consulta[AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md). 

**Argomento predefinito (AWS IoT Core MQTT):** `kinesisfirehose/message/status`

**Example Output di esempio**  
La risposta contiene lo stato di ogni record di dati inviati nel batch.  

```
{
  "response": [
    {
      "ErrorCode": "error",
      "ErrorMessage": "test error",
      "id": "request123",
      "status": "fail"
    },
    {
      "firehose_record_id": "xyz2",
      "id": "request456",
      "status": "success"
    },
    {
      "firehose_record_id": "xyz3",
      "id": "request890",
      "status": "success"
    }
  ]
}
```

**Nota**  <a name="connector-component-retryable-error"></a>
Se il componente rileva un errore che può essere riprovato, ad esempio un errore di connessione, riprova la pubblicazione nel batch successivo.

## File di registro locale
<a name="kinesis-firehose-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.KinesisFirehose.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.KinesisFirehose.log
  ```

## Licenze
<a name="kinesis-firehose-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:<a name="boto-3-licenses"></a>
+ [AWS SDK per Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="kinesis-firehose-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.10  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.6  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.5  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.4  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/kinesis-firehose-component.html)  | 
|  2.0.8  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

## Consulta anche
<a name="kinesis-firehose-component-see-also"></a>
+ [Che cos'è Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) nella *Amazon Data Firehose* Developer Guide

# Lanciatore Lambda
<a name="lambda-launcher-component"></a>

Il componente di avvio Lambda (`aws.greengrass.LambdaLauncher`) avvia e interrompe AWS Lambda le funzioni sui AWS IoT Greengrass dispositivi principali. Questo componente imposta anche qualsiasi containerizzazione ed esegue i processi secondo gli utenti specificati.

**Nota**  <a name="lambda-component-dependency-note"></a>
Quando si distribuisce un componente della funzione Lambda su un dispositivo principale, la distribuzione include anche questo componente. Per ulteriori informazioni, consulta [Esegui AWS Lambda funzioni](run-lambda-functions.md).

**Topics**
+ [Versioni](#lambda-launcher-component-versions)
+ [Tipo](#lambda-launcher-component-type)
+ [Sistema operativo](#lambda-launcher-component-os-support)
+ [Requisiti](#lambda-launcher-component-requirements)
+ [Dipendenze](#lambda-launcher-component-dependencies)
+ [Configurazione](#lambda-launcher-component-configuration)
+ [File di registro locale](#lambda-launcher-component-log-file)
+ [Changelog](#lambda-launcher-component-changelog)

## Versioni
<a name="lambda-launcher-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x

## Tipo
<a name="lambda-launcher-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="lambda-launcher-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="lambda-launcher-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ Il componente di avvio Lambda è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="lambda-launcher-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#lambda-launcher-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.0.11 – 2.0.13 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.11 a 2.0.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Gestore Lambda](lambda-manager-component.md) | >=2.0.0 <2.4.0  | Rigidi | 

------
#### [ 2.0.9 – 2.0.10 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.9 a 2.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Gestore Lambda](lambda-manager-component.md) | >=2.0.0 <2.3.0  | Rigidi | 

------
#### [ 2.0.4 - 2.0.8 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.4 a 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Gestore Lambda](lambda-manager-component.md) | >=2.0.0 <2.2.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Gestore Lambda](lambda-manager-component.md) | >=2.0.3 <2.1.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="lambda-launcher-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="lambda-launcher-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/lambdaFunctionComponentName.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale e sostituisci *lambdaFunctionComponentName* con il nome del componente della funzione Lambda avviato da questo componente.

  ```
  sudo tail -f /greengrass/v2/logs/lambdaFunctionComponentName.log
  ```

## Changelog
<a name="lambda-launcher-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.13  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-launcher-component.html)  | 
|  2.0.12  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-launcher-component.html)  | 
|  2.0.11  |  Support per Lambda manager 2.3.0.  | 
|  2.0.10  |  <a name="changelog-lambda-launcher-2.0.10"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-launcher-component.html)  | 
|  2.0.9  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.8  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.6  |  Miglioramenti delle prestazioni generali e correzioni di bug.  | 
|  2.0.4  |  <a name="changelog-lambda-launcher-2.0.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-launcher-component.html)  | 
|  2.0.3  |  Versione iniziale.  | 

# Gestore Lambda
<a name="lambda-manager-component"></a>

Il componente Lambda manager (`aws.greengrass.LambdaManager`) gestisce gli elementi di lavoro e la comunicazione tra processi per AWS Lambda le funzioni eseguite sul dispositivo principale Greengrass.

**Nota**  <a name="lambda-component-dependency-note"></a>
Quando si distribuisce un componente della funzione Lambda su un dispositivo principale, la distribuzione include anche questo componente. Per ulteriori informazioni, consulta [Esegui AWS Lambda funzioni](run-lambda-functions.md).

**Topics**
+ [Versioni](#lambda-manager-component-versions)
+ [Sistema operativo](#lambda-manager-component-os-support)
+ [Tipo](#lambda-manager-component-type)
+ [Requisiti](#lambda-manager-component-requirements)
+ [Dipendenze](#lambda-manager-component-dependencies)
+ [Configurazione](#lambda-manager-component-configuration)
+ [File di registro locale](#lambda-manager-component-log-file)
+ [Changelog](#lambda-manager-component-changelog)

## Versioni
<a name="lambda-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Sistema operativo
<a name="lambda-manager-component-os-support"></a>

Questo componente può essere installato solo su dispositivi core Linux.

## Tipo
<a name="lambda-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin (`aws.greengrass.plugin`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Requisiti
<a name="lambda-manager-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ Il componente Lambda manager è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="lambda-manager-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#lambda-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.3.7 ]

La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Flessibili | 

------
#### [ 2.3.6 ]

La tabella seguente elenca le dipendenze per la versione 2.3.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.16.0  | Flessibili | 

------
#### [ 2.3.5 ]

La tabella seguente elenca le dipendenze per la versione 2.3.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.15.0  | Flessibili | 

------
#### [ 2.3.4 ]

La tabella seguente elenca le dipendenze per la versione 2.3.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.14.0  | Flessibili | 

------
#### [ 2.3.2 and 2.3.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.2 e 2.3.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.13.0  | Flessibili | 

------
#### [ 2.2.10 and 2.3.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.10 e 2.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.12.0  | Flessibili | 

------
#### [ 2.2.8 and 2.2.9 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.8 e 2.2.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.11.0  | Flessibili | 

------
#### [ 2.2.7 ]

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.10.0  | Flessibili | 

------
#### [ 2.2.6 ]

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.9.0  | Flessibili | 

------
#### [ 2.2.5 ]

La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.8.0  | Flessibili | 

------
#### [ 2.2.4 ]

La tabella seguente elenca le dipendenze per la versione 2.2.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.7.0  | Flessibili | 

------
#### [ 2.2.1 - 2.2.3 ]

La tabella seguente elenca le dipendenze per le versioni da 2.2.1 a 2.2.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.6.0  | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.5.0 <2.6.0  | Flessibili | 

------
#### [ 2.1.3 and 2.1.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.3 e 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.5.0  | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.4.0  | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.3.0  | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.2.0  | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="lambda-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`logHandlerMode`  
Solo per le versioni 2.3.0\$1 di lambda manager 
Utilizzato per scegliere l'implementazione del Lambda log manager da utilizzare. Imposta il valore in modo `optimized` da utilizzare meno thread per leggere i log lambda.

`getResultTimeoutInSecond`  
(Facoltativo) La quantità massima di tempo in secondi in cui le funzioni Lambda possono essere eseguite prima del timeout.  
Impostazione predefinita: `60`

## File di registro locale
<a name="lambda-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

```
/greengrass/v2/logs/greengrass.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

## Changelog
<a name="lambda-manager-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.3.7  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.3.6  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.3.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.3.4  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.3.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.3.2  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.3.1  |  <a name="changelog-lambda-manager-2.3.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.11  |  <a name="changelog-lambda-manager-2.2.11"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.2.9  |  <a name="changelog-lambda-manager-2.2.9"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.8  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.2.7  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.2.6  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.2.5  |  <a name="changelog-lambda-manager-2.2.5"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.4  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.2.0  |  <a name="changelog-lambda-manager-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.1.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-manager-component.html)  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

# Runtime Lambda
<a name="lambda-runtimes-component"></a>

Il componente Lambda runtimes (`aws.greengrass.LambdaRuntimes`) fornisce i runtime utilizzati dai dispositivi core Greengrass per eseguire le funzioni. AWS Lambda 

**Nota**  <a name="lambda-component-dependency-note"></a>
Quando si distribuisce un componente della funzione Lambda su un dispositivo principale, la distribuzione include anche questo componente. Per ulteriori informazioni, consulta [Esegui AWS Lambda funzioni](run-lambda-functions.md).

**Topics**
+ [Versioni](#lambda-runtimes-component-versions)
+ [Tipo](#lambda-runtimes-component-type)
+ [Sistema operativo](#lambda-runtimes-component-os-support)
+ [Requisiti](#lambda-runtimes-component-requirements)
+ [Dipendenze](#lambda-runtimes-component-dependencies)
+ [Configurazione](#lambda-runtimes-component-configuration)
+ [File di registro locale](#lambda-runtimes-component-log-file)
+ [Changelog](#lambda-runtimes-component-changelog)

## Versioni
<a name="lambda-runtimes-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x

## Tipo
<a name="lambda-runtimes-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="lambda-runtimes-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="lambda-runtimes-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ Il componente Lambda runtimes è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="lambda-runtimes-component-dependencies"></a>

Questo componente non ha alcuna dipendenza.

## Configurazione
<a name="lambda-runtimes-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="lambda-runtimes-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="lambda-runtimes-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.9  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/lambda-runtimes-component.html)  | 
|  2.0.8  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

# Router di abbonamento legacy
<a name="legacy-subscription-router-component"></a>

Il router di abbonamento legacy (`aws.greengrass.LegacySubscriptionRouter`) gestisce gli abbonamenti sul dispositivo principale Greengrass. Le sottoscrizioni sono una funzionalità della AWS IoT Greengrass V1 che definisce gli argomenti che le funzioni Lambda possono utilizzare per la messaggistica MQTT su un dispositivo principale. *Per ulteriori informazioni, consulta [Sottoscrizioni gestite nel flusso di lavoro di messaggistica MQTT nella](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-sec.html#gg-msg-workflow) V1 Developer Guide.AWS IoT Greengrass *

È possibile utilizzare questo componente per abilitare gli abbonamenti per i componenti del connettore e i componenti della funzione Lambda che utilizzano Core SDK AWS IoT Greengrass .

**Nota**  <a name="legacy-subscription-router-requirement-note"></a>
Il componente legacy del router di abbonamento è richiesto solo se la funzione Lambda utilizza la `publish()` funzione nel AWS IoT Greengrass Core SDK. Se aggiorni il codice della funzione Lambda per utilizzare l'interfaccia di comunicazione tra processi (IPC) nella SDK per dispositivi AWS IoT V2, non è necessario implementare il componente legacy del router di abbonamento. [Per ulteriori informazioni, consulta i seguenti servizi di comunicazione tra processi:](interprocess-communication.md)  
[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
[AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)

**Topics**
+ [Versioni](#legacy-subscription-router-component-versions)
+ [Tipo](#legacy-subscription-router-component-type)
+ [Sistema operativo](#legacy-subscription-router-component-os-support)
+ [Requisiti](#legacy-subscription-router-component-requirements)
+ [Dipendenze](#legacy-subscription-router-component-dependencies)
+ [Configurazione](#legacy-subscription-router-component-configuration)
+ [File di registro locale](#legacy-subscription-router-component-log-file)
+ [Changelog](#legacy-subscription-router-component-changelog)

## Versioni
<a name="legacy-subscription-router-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="legacy-subscription-router-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico (`aws.greengrass.generic`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="legacy-subscription-router-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="legacy-subscription-router-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ Il router di abbonamento legacy è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="legacy-subscription-router-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#legacy-subscription-router-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.15 ]

La tabella seguente elenca le dipendenze per la versione 2.1.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Flessibili | 

------
#### [ 2.1.14 ]

La tabella seguente elenca le dipendenze per la versione 2.1.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Flessibili | 

------
#### [ 2.1.13 ]

La tabella seguente elenca le dipendenze per la versione 2.1.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Flessibili | 

------
#### [ 2.1.12 ]

La tabella seguente elenca le dipendenze per la versione 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Flessibili | 

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="legacy-subscription-router-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v2.1.x ]

`subscriptions`  
<a name="legacy-subscription-router-component-configuration-subscriptions-intro"></a>(Facoltativo) Gli abbonamenti da abilitare sul dispositivo principale. Si tratta di un oggetto, in cui ogni chiave è un ID univoco e ogni valore è un oggetto che definisce l'abbonamento per quel connettore. È necessario configurare un abbonamento quando si distribuisce un componente connettore V1 o una funzione Lambda che utilizza Core SDK. AWS IoT Greengrass   
Ogni oggetto di sottoscrizione contiene le seguenti informazioni:    
`id`  <a name="legacy-subscription-router-component-configuration-subscription-id"></a>
L'ID univoco di questo abbonamento. Questo ID deve corrispondere alla chiave per questo oggetto di sottoscrizione.  
`source`  
La funzione Lambda che utilizza AWS IoT Greengrass Core SDK per pubblicare messaggi MQTT sugli argomenti specificati. `subject` Specifica una delle seguenti proprietà:  
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-component-name"></a>Il nome di un componente della funzione Lambda sul dispositivo principale. Specificate il nome del componente con il `component:` prefisso, ad esempio. **component:com.example.HelloWorldLambda**
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>L'Amazon Resource Name (ARN) di una funzione Lambda sul dispositivo principale.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se la versione della funzione Lambda cambia, è necessario configurare l'abbonamento con la nuova versione della funzione. Altrimenti, questo componente non indirizzerà i messaggi finché la versione non corrisponderà all'abbonamento.  
È necessario specificare un Amazon Resource Name (ARN) che includa la versione della funzione da importare. Non è possibile utilizzare alias di versione come `$LATEST`.
Per distribuire un abbonamento per un componente del connettore V1, specifica il nome del componente o l'ARN della funzione Lambda del componente connettore.  
`subject`  <a name="legacy-subscription-router-component-configuration-subscription-subject"></a>
L'argomento o il filtro degli argomenti MQTT su cui l'origine e la destinazione possono pubblicare e ricevere messaggi. Questo valore supporta i caratteri jolly degli `#` argomenti `+` e degli argomenti.  
`target`  
<a name="legacy-subscription-router-component-configuration-subscription-target-intro"></a>La destinazione che riceve i messaggi MQTT sugli argomenti specificati in. `subject` L'abbonamento specifica che la `source` funzione pubblica messaggi MQTT su AWS IoT Core o verso una funzione Lambda sul dispositivo principale. Specifica una delle seguenti proprietà:  
+ <a name="legacy-subscription-router-component-configuration-subscription-target-cloud"></a>`cloud`. La `source` funzione pubblica messaggi MQTT su. AWS IoT Core
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-component-name"></a>Il nome di un componente della funzione Lambda sul dispositivo principale. Specificate il nome del componente con il `component:` prefisso, ad esempio. **component:com.example.HelloWorldLambda**
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>L'Amazon Resource Name (ARN) di una funzione Lambda sul dispositivo principale.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se la versione della funzione Lambda cambia, è necessario configurare l'abbonamento con la nuova versione della funzione. Altrimenti, questo componente non indirizzerà i messaggi finché la versione non corrisponderà all'abbonamento.  
È necessario specificare un Amazon Resource Name (ARN) che includa la versione della funzione da importare. Non è possibile utilizzare alias di versione come `$LATEST`.
Impostazione predefinita: nessun abbonamento

**Example Esempio di aggiornamento della configurazione (definizione di un abbonamento a AWS IoT Core)**  
L'esempio seguente specifica che il componente della funzione `com.example.HelloWorldLambda` Lambda pubblica un messaggio AWS IoT Core MQTT sull'argomento. `hello/world`  

```
{
  "subscriptions": {
    "Greengrass_HelloWorld_to_cloud": {
      "id": "Greengrass_HelloWorld_to_cloud",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "cloud"
    }
  }
}
```

**Example Esempio di aggiornamento della configurazione (definizione di un abbonamento a un'altra funzione Lambda)**  
L'esempio seguente specifica che il componente funzione `com.example.HelloWorldLambda` Lambda pubblica messaggi MQTT sul componente della funzione `com.example.MessageRelay` Lambda sull'argomento. `hello/world`  

```
{
  "subscriptions": {
    "Greengrass_HelloWorld_to_MessageRelay": {
      "id": "Greengrass_HelloWorld_to_MessageRelay",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "component:com.example.MessageRelay"
    }
  }
}
```

------
#### [ v2.0.x ]

`subscriptions`  
<a name="legacy-subscription-router-component-configuration-subscriptions-intro"></a>(Facoltativo) Gli abbonamenti da abilitare sul dispositivo principale. Si tratta di un oggetto, in cui ogni chiave è un ID univoco e ogni valore è un oggetto che definisce l'abbonamento per quel connettore. È necessario configurare un abbonamento quando si distribuisce un componente connettore V1 o una funzione Lambda che utilizza Core SDK. AWS IoT Greengrass   
Ogni oggetto di sottoscrizione contiene le seguenti informazioni:    
`id`  <a name="legacy-subscription-router-component-configuration-subscription-id"></a>
L'ID univoco di questo abbonamento. Questo ID deve corrispondere alla chiave per questo oggetto di sottoscrizione.  
`source`  
La funzione Lambda che utilizza AWS IoT Greengrass Core SDK per pubblicare messaggi MQTT sugli argomenti specificati. `subject` Specificare le impostazioni seguenti:  
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>L'Amazon Resource Name (ARN) di una funzione Lambda sul dispositivo principale.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se la versione della funzione Lambda cambia, è necessario configurare l'abbonamento con la nuova versione della funzione. Altrimenti, questo componente non indirizzerà i messaggi finché la versione non corrisponderà all'abbonamento.  
È necessario specificare un Amazon Resource Name (ARN) che includa la versione della funzione da importare. Non è possibile utilizzare alias di versione come `$LATEST`.
Per distribuire un abbonamento per un componente del connettore V1, specifica l'ARN della funzione Lambda del componente connettore.  
`subject`  <a name="legacy-subscription-router-component-configuration-subscription-subject"></a>
L'argomento o il filtro degli argomenti MQTT su cui l'origine e la destinazione possono pubblicare e ricevere messaggi. Questo valore supporta i caratteri jolly degli `#` argomenti `+` e degli argomenti.  
`target`  
<a name="legacy-subscription-router-component-configuration-subscription-target-intro"></a>La destinazione che riceve i messaggi MQTT sugli argomenti specificati in. `subject` L'abbonamento specifica che la `source` funzione pubblica messaggi MQTT su AWS IoT Core o verso una funzione Lambda sul dispositivo principale. Specifica una delle seguenti proprietà:  
+ <a name="legacy-subscription-router-component-configuration-subscription-target-cloud"></a>`cloud`. La `source` funzione pubblica messaggi MQTT su. AWS IoT Core
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>L'Amazon Resource Name (ARN) di una funzione Lambda sul dispositivo principale.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se la versione della funzione Lambda cambia, è necessario configurare l'abbonamento con la nuova versione della funzione. Altrimenti, questo componente non indirizzerà i messaggi finché la versione non corrisponderà all'abbonamento.  
È necessario specificare un Amazon Resource Name (ARN) che includa la versione della funzione da importare. Non è possibile utilizzare alias di versione come `$LATEST`.
Impostazione predefinita: nessun abbonamento

**Example Esempio di aggiornamento della configurazione (definizione di un abbonamento a AWS IoT Core)**  
L'esempio seguente specifica che la `Greengrass_HelloWorld` funzione pubblica un messaggio MQTT AWS IoT Core sull'argomento. `hello/world`  

```
"subscriptions": {
  "Greengrass_HelloWorld_to_cloud": {
    "id": "Greengrass_HelloWorld_to_cloud",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "cloud"
  }
}
```

**Example Esempio di aggiornamento della configurazione (definizione di un abbonamento a un'altra funzione Lambda)**  
L'esempio seguente specifica che la `Greengrass_HelloWorld` funzione pubblica messaggi MQTT su on the `Greengrass_MessageRelay` topic. `hello/world`  

```
"subscriptions": {
  "Greengrass_HelloWorld_to_MessageRelay": {
    "id": "Greengrass_HelloWorld_to_MessageRelay",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5"
  }
}
```

------

## File di registro locale
<a name="legacy-subscription-router-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="legacy-subscription-router-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.15  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.1.14  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.1.13  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.1.12  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  <a name="changelog-legacy-subscription-router-2.1.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/legacy-subscription-router-component.html)  | 
|  2.0.3  |  Versione iniziale.  | 

# Console di debug locale
<a name="local-debug-console-component"></a>

Il componente della console di debug locale (`aws.greengrass.LocalDebugConsole`) fornisce una dashboard locale che mostra informazioni sui dispositivi AWS IoT Greengrass principali e sui relativi componenti. È possibile utilizzare questa dashboard per eseguire il debug del dispositivo principale e gestire i componenti locali.

**Importante**  
 <a name="local-dev-tools-production-environment-warning"></a>Ti consigliamo di utilizzare questo componente solo in ambienti di sviluppo, non in ambienti di produzione. Questo componente fornisce l'accesso a informazioni e operazioni che in genere non sono necessarie in un ambiente di produzione. Segui il principio del privilegio minimo distribuendo questo componente solo sui dispositivi principali dove ne hai bisogno. 

**Topics**
+ [Versioni](#local-debug-console-component-versions)
+ [Tipo](#local-debug-console-component-type)
+ [Sistema operativo](#local-debug-console-component-os-support)
+ [Requisiti](#local-debug-console-component-requirements)
+ [Dipendenze](#local-debug-console-component-dependencies)
+ [Configurazione](#local-debug-console-component-configuration)
+ [Utilizzo](#local-debug-console-component-usage)
+ [File di registro locale](#local-debug-console-component-log-file)
+ [Changelog](#local-debug-console-component-changelog)

## Versioni
<a name="local-debug-console-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="local-debug-console-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="local-debug-console-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="local-debug-console-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Utilizzi un nome utente e una password per accedere alla dashboard. Il nome utente, che è`debug`, viene fornito all'utente. È necessario utilizzare la AWS IoT Greengrass CLI per creare una password temporanea che ti autentichi con la dashboard su un dispositivo principale. È necessario essere in grado di utilizzare la AWS IoT Greengrass CLI per utilizzare la console di debug locale. Per ulteriori informazioni, consulta i requisiti della [CLI di Greengrass](greengrass-cli-component.md#greengrass-cli-component-requirements). Per ulteriori informazioni su come generare la password e accedere, vedere Utilizzo dei componenti della [console di debug locale](#local-debug-console-component-usage).
+ Il componente della console di debug locale è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="local-debug-console-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#local-debug-console-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.4.6 ]

La tabella seguente elenca le dipendenze per la versione 2.4.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.17.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.17.0 | Rigidi | 

------
#### [ 2.4.5 ]

La tabella seguente elenca le dipendenze per la versione 2.4.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.16.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.16.0 | Rigidi | 

------
#### [ 2.4.4 ]

La tabella seguente elenca le dipendenze per la versione 2.4.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.15.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.15.0 | Rigidi | 

------
#### [ 2.4.3 ]

La tabella seguente elenca le dipendenze per la versione 2.4.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.14.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.14.0 | Rigidi | 

------
#### [ 2.4.1 – 2.4.2 ]

La tabella seguente elenca le dipendenze per le versioni da 2.4.1 a 2.4.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.13.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.13.0 | Rigidi | 

------
#### [ 2.4.0 ]

La tabella seguente elenca le dipendenze per la versione 2.4.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Rigidi | 

------
#### [ 2.3.0 and 2.3.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Rigidi | 

------
#### [ 2.2.9 ]

La tabella seguente elenca le dipendenze per la versione 2.2.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.12.0 | Rigidi | 

------
#### [ 2.2.8 ]

La tabella seguente elenca le dipendenze per la versione 2.2.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.11.0 | Rigidi | 

------
#### [ 2.2.7 ]

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.10.0 | Rigidi | 

------
#### [ 2.2.6 ]

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.9.0 | Rigidi | 

------
#### [ 2.2.5 ]

La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.8.0 | Rigidi | 

------
#### [ 2.2.4 ]

La tabella seguente elenca le dipendenze per la versione 2.2.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.7.0 | Rigidi | 

------
#### [ 2.2.3 ]

La tabella seguente elenca le dipendenze per la versione 2.2.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.6.0 | Rigidi | 

------
#### [ 2.2.2 ]

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.5.0 | Rigidi | 

------
#### [ 2.2.1 ]

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.4.0 | Rigidi | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.3.0 | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.2.0 | Rigidi | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 
| [Greengrass CLI](greengrass-cli-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="local-debug-console-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v2.1.x - v2.4.x ]

`httpsEnabled`  
(Facoltativo) È possibile abilitare la comunicazione HTTPS per la console di debug locale. Se si abilita la comunicazione HTTPS, la console di debug locale crea un certificato autofirmato. I browser Web mostrano avvisi di sicurezza per i siti Web che utilizzano certificati autofirmati, pertanto è necessario verificare manualmente il certificato. È quindi possibile ignorare l'avviso. Per ulteriori informazioni, consulta [Utilizzo](#local-debug-console-component-usage).  
Default: `true`

`port`  <a name="local-debug-console-component-configuration-port"></a>
(Facoltativo) La porta alla quale fornire la console di debug locale.  
Impostazione predefinita: `1441`

`websocketPort`  <a name="local-debug-console-component-configuration-websocket-port"></a>
(Facoltativo) La porta websocket da utilizzare per la console di debug locale.  
Impostazione predefinita: `1442`

`bindHostname`  <a name="local-debug-console-component-configuration-bind-hostname"></a>
(Facoltativo) Il nome host da utilizzare per la console di debug locale.  
Se [esegui il software AWS IoT Greengrass Core in un contenitore Docker](run-greengrass-docker.md), imposta questo parametro su, in modo da `0.0.0.0` poter aprire la console di debug locale all'esterno del contenitore Docker.  
Impostazione predefinita: `localhost`

**Example Esempio: aggiornamento basato sull'unione della configurazione**  
La configurazione di esempio seguente specifica di aprire la console di debug locale su porte non predefinite e disabilitare HTTPS.  

```
{
  "httpsEnabled": false,
  "port": "10441",
  "websocketPort": "10442"
}
```

------
#### [ v2.0.x ]

`port`  <a name="local-debug-console-component-configuration-port"></a>
(Facoltativo) La porta alla quale fornire la console di debug locale.  
Impostazione predefinita: `1441`

`websocketPort`  <a name="local-debug-console-component-configuration-websocket-port"></a>
(Facoltativo) La porta websocket da utilizzare per la console di debug locale.  
Impostazione predefinita: `1442`

`bindHostname`  <a name="local-debug-console-component-configuration-bind-hostname"></a>
(Facoltativo) Il nome host da utilizzare per la console di debug locale.  
Se [esegui il software AWS IoT Greengrass Core in un contenitore Docker](run-greengrass-docker.md), imposta questo parametro su, in modo da `0.0.0.0` poter aprire la console di debug locale all'esterno del contenitore Docker.  
Impostazione predefinita: `localhost`

**Example Esempio: aggiornamento basato sull'unione della configurazione**  
La configurazione di esempio seguente specifica di aprire la console di debug locale su porte non predefinite.  

```
{
  "port": "10441",
  "websocketPort": "10442"
}
```

------

## Utilizzo
<a name="local-debug-console-component-usage"></a>

Per utilizzare la console di debug locale, create una sessione dalla CLI di Greengrass. Quando si crea una sessione, la CLI di Greengrass fornisce un nome utente e una password temporanea che è possibile utilizzare per accedere alla console di debug locale.

Segui queste istruzioni per aprire la console di debug locale sul tuo dispositivo principale o sul tuo computer di sviluppo.

------
#### [ v2.1.x - v2.4.x ]

Nelle versioni 2.1.0 e successive, la console di debug locale utilizza HTTPS per impostazione predefinita. Quando HTTPS è abilitato, la console di debug locale crea un certificato autofirmato per proteggere la connessione. Il browser Web mostra un avviso di sicurezza quando si apre la console di debug locale a causa di questo certificato autofirmato. Quando si crea una sessione con la Greengrass CLI, l'output include le impronte digitali del certificato, in modo da poter verificare che il certificato sia legittimo e che la connessione sia sicura.

È possibile disabilitare HTTPS. Per ulteriori informazioni, consulta [Configurazione della console di debug locale](#local-debug-console-component-configuration).

**Per aprire la console di debug locale**

1. <a name="local-debug-console-component-usage-forward-port"></a>(Facoltativo) Per visualizzare la console di debug locale sul tuo computer di sviluppo, puoi inoltrare la porta della console tramite SSH. Tuttavia, è necessario prima abilitare l'`AllowTcpForwarding`opzione nel file di configurazione SSH del dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il comando seguente sul tuo computer di sviluppo per visualizzare la dashboard `localhost:1441` sul tuo computer di sviluppo.

   ```
   ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
   ```
**Nota**  
È possibile modificare le porte predefinite da `1441` e`1442`. Per ulteriori informazioni, vedere [Configurazione della console di debug locale](#local-debug-console-component-configuration).

1. <a name="local-debug-console-component-create-session-step"></a>Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale. La console di debug locale crea anche un certificato per proteggere la connessione se si abilita HTTPS nella configurazione del componente. HTTPS è abilitato per impostazione predefinita.

   Usa la AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella principale AWS IoT Greengrass V2 .

------
#### [ Linux or Unix ]

   ```
   sudo /greengrass/v2/bin/greengrass-cli get-debug-password
   ```

------
#### [ Windows ]

   ```
   C:\greengrass\v2\bin\greengrass-cli get-debug-password
   ```

------

   L'output del comando è simile al seguente esempio se la console di debug locale è stata configurata per l'utilizzo di HTTPS. Le impronte digitali del certificato vengono utilizzate per verificare che la connessione sia sicura quando si apre la console di debug locale.

   ```
   Username: debug
   Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
   Password expires at: 2021-04-01T17:01:43.921999931-07:00
   The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
   Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
   SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
   SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1
   ```

   Il componente debug view crea una sessione che dura 8 ore. Dopodiché, è necessario generare una nuova password per visualizzare nuovamente la console di debug locale. 

1. Apri e accedi alla dashboard. Visualizza la dashboard sul tuo dispositivo principale Greengrass o sul tuo computer di sviluppo se inoltri la porta tramite SSH. Esegui una di queste operazioni:
   + Se hai abilitato HTTPS nella console di debug locale, che è l'impostazione predefinita, procedi come segue:

     1. Apri `https://localhost:1441` sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

        Il tuo browser potrebbe mostrare un avviso di sicurezza relativo a un certificato di sicurezza non valido.

     1. Se il tuo browser mostra un avviso di sicurezza, verifica che il certificato sia legittimo e ignora l'avviso di sicurezza. Esegui questa operazione:

        1. Trova l'impronta digitale SHA-256 o SHA-1 del certificato e verifica che corrisponda all'impronta digitale SHA-256 o SHA-1 stampata in precedenza dal comando. `get-debug-password` Il tuo browser potrebbe fornire una o entrambe le impronte digitali. Consulta la documentazione del tuo browser per visualizzare il certificato e le relative impronte digitali. In alcuni browser, l'impronta digitale del certificato viene chiamata impronta digitale.
**Nota**  
Se l'impronta digitale del certificato non corrisponde, vai [Step 2](#local-debug-console-component-create-session-step) a creare una nuova sessione. Se l'impronta digitale del certificato continua a non corrispondere, la connessione potrebbe non essere sicura.

        1. Se l'impronta digitale del certificato corrisponde, ignora l'avviso di sicurezza del browser per aprire la console di debug locale. Consultate la documentazione del browser per aggirare l'avviso di sicurezza del browser.

     1. Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il `get-debug-password` comando.

        Si apre la console di debug locale.

     1. Se la console di debug locale mostra un errore che indica che non è possibile connettersi a the a WebSocket causa di un handshake TLS non riuscito, è necessario ignorare l'avviso di sicurezza autofirmato per l'URL. WebSocket   
![\[L'errore di handshake WebSocket TLS nella console di debug locale.\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/images/local-debug-console/websocket-tls-handshake-error.png)

        Esegui questa operazione:

        1. Apri `https://localhost:1442` nello stesso browser in cui hai aperto la console di debug locale.

        1. Verifica il certificato e ignora l'avviso di sicurezza.

           Il browser potrebbe mostrare una pagina HTTP 404 dopo aver ignorato l'avviso.

        1. `https://localhost:1441`Riapri.

           La console di debug locale mostra informazioni sul dispositivo principale.
   + Se hai disabilitato HTTPS nella console di debug locale, procedi come segue:

     1. <a name="local-debug-console-component-usage-open-localhost-http"></a>Apri `http://localhost:1441` sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

     1. <a name="local-debug-console-component-usage-sign-in"></a>Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il `get-debug-password` comando.

        Si apre la console di debug locale.

------
#### [ v2.0.x ]

**Per aprire la console di debug locale**

1. <a name="local-debug-console-component-usage-forward-port"></a>(Facoltativo) Per visualizzare la console di debug locale sul tuo computer di sviluppo, puoi inoltrare la porta della console tramite SSH. Tuttavia, è necessario prima abilitare l'`AllowTcpForwarding`opzione nel file di configurazione SSH del dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il comando seguente sul tuo computer di sviluppo per visualizzare la dashboard `localhost:1441` sul tuo computer di sviluppo.

   ```
   ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
   ```
**Nota**  
È possibile modificare le porte predefinite da `1441` e`1442`. Per ulteriori informazioni, vedere [Configurazione della console di debug locale](#local-debug-console-component-configuration).

1. Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale.

   Usa la AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella principale AWS IoT Greengrass V2 .

------
#### [ Linux or Unix ]

   ```
   sudo /greengrass/v2/bin/greengrass-cli get-debug-password
   ```

------
#### [ Windows ]

   ```
   C:\greengrass\v2\bin\greengrass-cli get-debug-password
   ```

------

   L'output del comando è simile all'esempio seguente.

   ```
   Username: debug
   Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
   Password will expire at: 2021-04-01T17:01:43.921999931-07:00
   ```

   Il componente debug view crea una sessione della durata di 4 ore, quindi è necessario generare una nuova password per visualizzare nuovamente la console di debug locale.

1. <a name="local-debug-console-component-usage-open-localhost-http"></a>Apri `http://localhost:1441` sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

1. <a name="local-debug-console-component-usage-sign-in"></a>Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il `get-debug-password` comando.

   Si apre la console di debug locale.

------

## File di registro locale
<a name="local-debug-console-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="local-debug-console-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.4.6  |  Versione aggiornata per Greengrass nucleus versione 2.16.0.  | 
|  2.4.5  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.4.4  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.4.3  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html)  | 
|  2.4.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html)  | 
|  2.4.1  |  Versione aggiornata per Greengrass nucleus versione 2.12.0.  | 
|  2.4.0  |  <a name="changelog-local-debug-console-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html)  | 
|  2.3.1  |  Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.  | 
|  2.3.0  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html) | 
|  2.2.7  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.2.6  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.2.5  |  Versione aggiornata per Greengrass nucleus versione 2.7.0.  | 
|  2.2.4  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html)  | 
|  2.2.2  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.2.1  |  Versione aggiornata per Greengrass nucleus versione 2.3.0.  | 
|  2.2.0  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  <a name="changelog-local-debug-console-2.1.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/local-debug-console-component.html)  | 
|  2.0.3  |  Versione iniziale.  | 

# Gestore dei registri
<a name="log-manager-component"></a>

**avvertimento**  
Si consiglia l'aggiornamento a Log Manager v2.3.5 o versione successiva. La versione 2.3.5 ottimizza le scritture di configurazione di Log Manager, riducendo le operazioni di IO e migliorando la velocità di caricamento dei log, le prestazioni complessive del dispositivo e possibilmente prolungandone la durata.

Il componente log manager (`aws.greengrass.LogManager`) carica i log dai dispositivi AWS IoT Greengrass principali su Amazon CloudWatch Logs. Puoi caricare i log dal nucleo di Greengrass, da altri componenti Greengrass e da altre applicazioni e servizi che non sono componenti Greengrass. Per ulteriori informazioni su come monitorare i log in CloudWatch Logs e nel file system locale, vedere. [Monitora AWS IoT Greengrass i registri](monitor-logs.md)

<a name="log-manager-considerations-intro"></a>Le seguenti considerazioni si applicano quando si utilizza il componente log manager per scrivere nei registri: CloudWatch <a name="log-manager-considerations"></a>
+ **Registra i ritardi**

  La versione 2.2.8 (e precedenti) del componente di gestione dei log elabora e carica i log solo dai file di registro ruotati. Per impostazione predefinita, il software AWS IoT Greengrass Core ruota i file di registro ogni ora o dopo che hanno raggiunto i 1.024 KB. Di conseguenza, il componente log manager carica i log solo dopo che il software AWS IoT Greengrass Core o un componente Greengrass hanno scritto oltre 1.024 KB di log. È possibile configurare un limite inferiore per le dimensioni dei file di registro per far sì che i file di registro ruotino più spesso. Ciò fa sì che il componente log manager carichi i log in Logs più CloudWatch frequentemente.

  Il componente di gestione dei registri versione 2.3.0 (e successive) elabora e carica tutti i log. Quando si scrive un nuovo registro, la versione 2.3.0 (e successive) di log manager elabora e carica direttamente il file di registro attivo anziché attendere che venga ruotato. Ciò significa che è possibile visualizzare il nuovo registro in 5 minuti o meno.

  Il componente di gestione dei registri carica periodicamente nuovi registri. Per impostazione predefinita, il componente di gestione dei registri carica nuovi registri ogni 5 minuti. È possibile configurare un intervallo di caricamento inferiore, in modo che il componente log manager carichi i log in Logs più frequentemente configurando il CloudWatch . `periodicUploadIntervalSec` [Per ulteriori informazioni su come configurare questo intervallo periodico, vedere Configurazione.](https://docs.aws.amazon.com/greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration)

  I log possono essere caricati quasi in tempo reale dallo stesso file system Greengrass. Se hai bisogno di osservare i log in tempo reale, prendi in considerazione l'utilizzo dei log [del file system](monitor-logs.md#access-local-logs).
**Nota**  
Se utilizzi file system diversi su cui scrivere i log, log manager torna al comportamento delle versioni 2.2.8 e precedenti dei componenti di log manager. Per informazioni sull'accesso ai log del file system, consultate [Access](https://docs.aws.amazon.com/greengrass/v2/developerguide/monitor-logs.html#access-local-logs) file system logs.
+ **Inclinazione dell'orologio**

  Il componente log manager utilizza il processo di firma standard Signature Version 4 per creare richieste API per CloudWatch Logs. Se l'ora del sistema su un dispositivo principale non è sincronizzata per più di 15 minuti, CloudWatch Logs rifiuta le richieste. Per ulteriori informazioni, consulta la pagina relativa al [processo di firma Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) nella *Riferimenti generali di AWS*.

Per informazioni sui gruppi di log e sui flussi di log in cui questo componente carica i log, consulta. [Utilizzo](#log-manager-component-usage)

**Topics**
+ [Versioni](#log-manager-component-versions)
+ [Tipo](#log-manager-component-type)
+ [Sistema operativo](#log-manager-component-os-support)
+ [Requisiti](#log-manager-component-requirements)
+ [Dipendenze](#log-manager-component-dependencies)
+ [Configurazione](#log-manager-component-configuration)
+ [Utilizzo](#log-manager-component-usage)
+ [File di registro locale](#log-manager-component-log-file)
+ [Changelog](#log-manager-component-changelog)

## Versioni
<a name="log-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="log-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin (`aws.greengrass.plugin`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="log-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="log-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire le `logs:DescribeLogStreams` azioni`logs:CreateLogGroup`,`logs:CreateLogStream`, e`logs:PutLogEvents`,, come illustrato nel seguente esempio di policy IAM.

  ```
  {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "logs:CreateLogGroup",
          "logs:CreateLogStream",
          "logs:PutLogEvents",
          "logs:DescribeLogStreams"
        ],
        "Effect": "Allow",
        "Resource": "arn:aws:logs:*:*:*"
      }
    ]
  }
  ```
**Nota**  
Il [ruolo del dispositivo Greengrass](device-service-role.md) che crei quando installi il software AWS IoT Greengrass Core include per impostazione predefinita le autorizzazioni di questo criterio di esempio.

  Per ulteriori informazioni, consulta [Using Identity-Based Policy (IAM policies) for CloudWatch Logs nella *Amazon CloudWatch * Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) User Guide.
+ Il componente log manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente di gestione dei registri deve disporre di una connettività a `logs.region.amazonaws.com` cui abbia l'endpoint VPC di. `com.amazonaws.us-east-1.logs`

### Endpoint e porte
<a name="log-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | No |  Obbligatorio se si scrivono log in Logs. CloudWatch   | 

## Dipendenze
<a name="log-manager-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#log-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.3.11 ]

La tabella seguente elenca le dipendenze per la versione 2.3.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Flessibili | 

------
#### [ 2.3.10 ]

La tabella seguente elenca le dipendenze per la versione 2.3.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Flessibili | 

------
#### [ 2.3.9 ]

La tabella seguente elenca le dipendenze per la versione 2.3.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Flessibili | 

------
#### [ 2.3.8 ]

La tabella seguente elenca le dipendenze per la versione 2.3.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Flessibili | 

------
#### [ 2.3.7 ]

La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Flessibili | 

------
#### [ 2.3.5 and 2.3.6 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.5 e 2.3.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Flessibili | 

------
#### [ 2.3.3 – 2.3.4 ]

La tabella seguente elenca le dipendenze per le versioni da 2.3.3 a 2.3.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Flessibili | 

------
#### [ 2.2.8 – 2.3.2 ]

La tabella seguente elenca le dipendenze per le versioni da 2.2.8 a 2.3.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Flessibili | 

------
#### [ 2.2.7 ]

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Flessibili | 

------
#### [ 2.2.6 ]

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Flessibili | 

------
#### [ 2.2.5 ]

La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Flessibili | 

------
#### [ 2.2.1 - 2.2.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.1 - 2.2.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.3 and 2.2.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.3 e 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0  | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="log-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v2.3.10 ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
  `systemLogsConfiguration`   
[(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del [nucleo Greengrass](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per l'output di log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni `componentName` oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch   
Consigliamo vivamente di utilizzare una sola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file con un solo file di registro in cui viene scritto attivamente quando si utilizza`logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati in. CloudWatch [Se hai come target più file di log attivi con un'unica espressione regolare, ti consigliamo di eseguire l'aggiornamento a log manager v2.3.1 o versione successiva e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.](#log-manager-multiple-logs-v2.3.10)
Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. `componentLogsConfiguration` `componentLogsConfigurationMap` Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul `componentLogsConfiguration` parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.  
*`componentName`*  
La configurazione del registro per il *`componentName`* componente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
Ogni oggetto contiene le seguenti informazioni:    
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Default: `/greengrass/v2/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **hello\$1world\$1\$1\$1\$1w\$1.log** per un'applicazione Hello World. Il `\\\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `hello_world.log`— Il file di registro più recente per l'applicazione Hello World.
+ `hello_world_2020_12_15_17_0.log`— Un vecchio file di registro per l'applicazione Hello World.
Impostazione predefinita:`componentName\\\\w*.log`, *componentName* dov'è il nome del componente per questa configurazione di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

`updateToTlogIntervalSec`  
(Facoltativo) Il periodo in secondi con cui il nucleo scrive i dettagli degli eventi di Amazon CloudWatch Events caricamento dei registri nel registro delle transazioni locale (). `config.tlog` Il valore predefinito è il valore specificato in. `periodicUploadIntervalSec` È possibile modificare questo parametro per aumentare l'intervallo di scrittura.  
Impostazione predefinita: `periodicUploadIntervalSec`  
Minimo: `periodicUploadIntervalSec`

`deprecatedVersionSupport`  
Indica se il gestore dei registri deve utilizzare i miglioramenti della velocità di registrazione introdotti in log manager v2.3.5. Imposta il valore su cui utilizzare `false` i miglioramenti.  
Se si imposta questo valore su `false` quando si esegue l'aggiornamento da log manager v2.3.1 o versioni precedenti, è possibile che vengano caricate voci di registro duplicate.  
Il valore predefinito è `true`.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300",
  "deprecatedVersionSupport": "false"
}
```

**Example Esempio: configurazione per caricare più file di registro attivi utilizzando log manager v2.3.1**  
La configurazione di esempio seguente è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questo esempio di configurazione specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, la configurazione caricherà anche tutti i file ruotati che corrispondono a. `logFileRegex` Questa configurazione di esempio è supportata in log manager v2.3.1.  

```
{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.A": {
        "logFileRegex": "com.example.A\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
      "com.example.B": {
        "logFileRegex": "com.example.B\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "10"
}
```

------
#### [ v2.3.6 – v2.3.9 ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
  `systemLogsConfiguration`   
[(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del [nucleo Greengrass](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per l'output di log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni `componentName` oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch   
Consigliamo vivamente di utilizzare una sola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file con un solo file di registro in cui viene scritto attivamente quando si utilizza`logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati in. CloudWatch [Se hai come target più file di log attivi con un'unica espressione regolare, ti consigliamo di eseguire l'aggiornamento a log manager v2.3.1 o versione successiva e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.](#log-manager-multiple-logs-v2.3.1)
Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. `componentLogsConfiguration` `componentLogsConfigurationMap` Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul `componentLogsConfiguration` parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.  
*`componentName`*  
La configurazione del registro per il *`componentName`* componente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
Ogni oggetto contiene le seguenti informazioni:    
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Default: `/greengrass/v2/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **hello\$1world\$1\$1\$1\$1w\$1.log** per un'applicazione Hello World. Il `\\\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `hello_world.log`— Il file di registro più recente per l'applicazione Hello World.
+ `hello_world_2020_12_15_17_0.log`— Un vecchio file di registro per l'applicazione Hello World.
Impostazione predefinita:`componentName\\\\w*.log`, *componentName* dov'è il nome del componente per questa configurazione di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

`deprecatedVersionSupport`  
Indica se il gestore dei registri deve utilizzare i miglioramenti della velocità di registrazione introdotti in log manager v2.3.5. Imposta il valore su cui utilizzare `false` i miglioramenti.  
Se si imposta questo valore su `false` quando si esegue l'aggiornamento da log manager v2.3.1 o versioni precedenti, è possibile che vengano caricate voci di registro duplicate.  
Il valore predefinito è `true`.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300",
  "deprecatedVersionSupport": "false"
}
```

**Example Esempio: configurazione per caricare più file di registro attivi utilizzando log manager v2.3.1**  
La configurazione di esempio seguente è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questo esempio di configurazione specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, la configurazione caricherà anche tutti i file ruotati che corrispondono a. `logFileRegex` Questa configurazione di esempio è supportata in log manager v2.3.1.  

```
{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.A": {
        "logFileRegex": "com.example.A\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
      "com.example.B": {
        "logFileRegex": "com.example.B\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "10"
}
```

------
#### [ v2.3.0 – 2.3.5 ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
  `systemLogsConfiguration`   
[(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del [nucleo Greengrass](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni `componentName` oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch   
Consigliamo vivamente di utilizzare una sola chiave di configurazione per componente. È consigliabile scegliere come target solo un gruppo di file con un solo file di registro in cui viene scritto attivamente quando si utilizza`logFileRegex`. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati in. CloudWatch [Se hai come target più file di log attivi con un'unica espressione regolare, ti consigliamo di eseguire l'aggiornamento a log manager v2.3.1 e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.](#log-manager-multiple-logs-v2.3.1)
Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. `componentLogsConfiguration` `componentLogsConfigurationMap` Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul `componentLogsConfiguration` parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.  
*`componentName`*  
La configurazione del registro per il *`componentName`* componente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
Ogni oggetto contiene le seguenti informazioni:    
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Default: `/greengrass/v2/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **hello\$1world\$1\$1\$1\$1w\$1.log** per un'applicazione Hello World. Il `\\\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `hello_world.log`— Il file di registro più recente per l'applicazione Hello World.
+ `hello_world_2020_12_15_17_0.log`— Un vecchio file di registro per l'applicazione Hello World.
Impostazione predefinita:`componentName\\\\w*.log`, *componentName* dov'è il nome del componente per questa configurazione di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300"
}
```

**Example Esempio: configurazione per caricare più file di registro attivi utilizzando log manager v2.3.1**  
La configurazione di esempio seguente è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questo esempio di configurazione specifica in quali file di registro attivi si desidera caricare CloudWatch. Utilizzando questo esempio di configurazione, la configurazione caricherà anche tutti i file ruotati che corrispondono a. `logFileRegex` Questa configurazione di esempio è supportata in log manager v2.3.1.  

```
{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.A": {
        "logFileRegex": "com.example.A\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
      "com.example.B": {
        "logFileRegex": "com.example.B\\w*.log",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "10"
}
```

------
#### [ v2.2.x ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
  `systemLogsConfiguration`   
[(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del [nucleo Greengrass](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
  `componentLogsConfigurationMap`   
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni `componentName` oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente log manager carica questi registri dei componenti in Logs. CloudWatch   
Se stai eseguendo l'aggiornamento da una versione di log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. `componentLogsConfiguration` `componentLogsConfigurationMap` Tuttavia, ti consigliamo vivamente di utilizzare il formato della mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul `componentLogsConfiguration` parametro, consulta i parametri di configurazione per la versione 2.1.x di questo componente.   
*`componentName`*  
La configurazione del registro per il *`componentName`* componente o l'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
Ogni oggetto contiene le seguenti informazioni:    
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Default: `/greengrass/v2/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **hello\$1world\$1\$1\$1\$1w\$1.log** per un'applicazione Hello World. Il `\\\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `hello_world.log`— Il file di registro più recente per l'applicazione Hello World.
+ `hello_world_2020_12_15_17_0.log`— Un vecchio file di registro per l'applicazione Hello World.
Impostazione predefinita:`componentName\\\\w*.log`, *componentName* dov'è il nome del componente per questa configurazione di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

  `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    }
  },
  "periodicUploadIntervalSec": "300"
}
```

------
#### [ v2.1.x ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
 `systemLogsConfiguration`   
[(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core, che includono i registri del [nucleo Greengrass](greengrass-nucleus-component.md) e i componenti del plug-in.](develop-greengrass-components.md#component-types) Specificate questa configurazione per consentire al componente di gestione dei log di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
  `componentLogsConfiguration`   
(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente log manager carica questi registri dei componenti in Logs CloudWatch   
Ogni oggetto contiene le seguenti informazioni:    
`componentName`  <a name="log-manager-component-configuration-component-component-name"></a>
Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  <a name="log-manager-component-configuration-component-log-file-dir-path"></a>
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Default: `/greengrass/v2/logs`.  
`logFileRegex`  <a name="log-manager-component-configuration-component-log-file-regex"></a>
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).  
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **hello\$1world\$1\$1\$1\$1w\$1.log** per un'applicazione Hello World. Il `\\\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `hello_world.log`— Il file di registro più recente per l'applicazione Hello World.
+ `hello_world_2020_12_15_17_0.log`— Un vecchio file di registro per l'applicazione Hello World.
Impostazione predefinita:`componentName\\\\w*.log`, *componentName* dov'è il nome del componente per questa configurazione di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

 `periodicUploadIntervalSec`   
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfiguration": [
      {
        "componentName": "com.example.HelloWorld",
        "minimumLogLevel": "INFO",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    ]
  },
  "periodicUploadIntervalSec": "300"
}
```

------
#### [ v2.0.x ]

`logsUploaderConfiguration`  
(Facoltativo) La configurazione per i log caricati dal componente Log Manager. Questo oggetto contiene le seguenti informazioni:    
`systemLogsConfiguration`  
(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass Core. Specificate questa configurazione per consentire al componente di gestione dei log di gestire i registri di sistema. Questo oggetto contiene le seguenti informazioni:    
`uploadToCloudWatch`  <a name="log-manager-component-configuration-system-upload-to-cloud-watch"></a>
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.  
Impostazione predefinita: `false`  
`minimumLogLevel`  <a name="log-manager-component-configuration-system-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il [componente Greengrass nucleus](greengrass-nucleus-component.md) per generare log in formato JSON. [Per abilitare i log in formato JSON, specificate il parametro del formato `JSON` di registrazione ().](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) `logging.format`  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-system-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima dei file di registro del sistema Greengrass, nell'unità specificata. `diskSpaceLimitUnit` Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.  
Questo parametro è equivalente al parametro [log size limit](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Opzionale) L'unità per. `diskSpaceLimit` Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i registri in Logs. CloudWatch   
Impostazione predefinita: `false`  
`componentLogsConfiguration`  
(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente log manager carica questi registri dei componenti in Logs CloudWatch   
Ogni oggetto contiene le seguenti informazioni:    
`componentName`  <a name="log-manager-component-configuration-component-component-name"></a>
Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.  
`minimumLogLevel`  <a name="log-manager-component-configuration-component-minimum-log-level"></a>
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, che puoi trovare nel repository del [modulo di AWS IoT Greengrass registrazione](https://github.com/aws-greengrass/aws-greengrass-logging-java) su. GitHub  
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  <a name="nucleus-log-levels"></a>
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`  
`diskSpaceLimit`  <a name="log-manager-component-configuration-component-disk-space-limit"></a>
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificata`diskSpaceLimitUnit`. Dopo che la dimensione totale dei file di registro di questo componente supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.  
Questo parametro è correlato al parametro [limite di dimensione del registro](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) del componente [Greengrass nucleus](greengrass-nucleus-component.md). Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.  
`diskSpaceLimitUnit`  <a name="log-manager-component-configuration-disk-space-limit-unit"></a>
(Facoltativo) L'unità per`diskSpaceLimit`. Seleziona una delle opzioni seguenti:  
+ `KB`— kilobyte
+ `MB`— megabyte
+ `GB`— gigabyte
Impostazione predefinita: `KB`  
`logFileDirectoryPath`  
Il percorso della cartella che contiene i file di registro di questo componente.  
Per caricare i log di un componente Greengrass**`/greengrass/v2`/logs**, specificate e sostituiteli con `/greengrass/v2` la cartella principale di Greengrass.  
`logFileRegex`  
Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente log manager utilizza questa espressione regolare per identificare i file di registro nella cartella in`logFileDirectoryPath`.  
Per caricare i log di un componente Greengrass, specifica un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare i log **com.example.HelloWorld\$1\$1w\$1.log** per un componente Hello World. Il `\\w*` modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e caratteri di sottolineatura. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:  
+ `com.example.HelloWorld.log`— Il file di registro più recente per il componente Hello World.
+ `com.example.HelloWorld_2020_12_15_17_0.log`— Un vecchio file di registro per il componente Hello World. Il nucleo Greengrass aggiunge un timestamp rotante ai file di registro.  
`deleteLogFileAfterCloudUpload`  <a name="log-manager-component-configuration-delete-log-file-after-cloud-upload"></a>
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei registri ha caricato i log in Logs. CloudWatch   
Impostazione predefinita: `false`  
`multiLineStartPattern`  <a name="log-manager-component-configuration-component-multi-line-start-pattern"></a>
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente log manager aggiunge la nuova riga al messaggio di registro della riga precedente.  
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei registri gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente di gestione dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.

`periodicUploadIntervalSec`  
(Facoltativo) Il periodo in secondi in cui il componente di gestione dei registri verifica la presenza di nuovi file di registro da caricare.  
Impostazione predefinita: `300` (5 minuti)  
Minimo: `0.000001` (1 microsecondo)

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di caricare i registri di sistema e i registri dei `com.example.HelloWorld` componenti in Logs. CloudWatch   

```
{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true",
      "minimumLogLevel": "INFO",
      "diskSpaceLimit": "10",
      "diskSpaceLimitUnit": "MB",
      "deleteLogFileAfterCloudUpload": "false"
    },
    "componentLogsConfiguration": [
      {
        "componentName": "com.example.HelloWorld",
        "minimumLogLevel": "INFO",
        "logFileDirectoryPath": "/greengrass/v2/logs",
        "logFileRegex": "com.example.HelloWorld\\w*.log",
        "diskSpaceLimit": "20",
        "diskSpaceLimitUnit": "MB",
        "deleteLogFileAfterCloudUpload": "false"
      }
    ]
  },
  "periodicUploadIntervalSec": "300"
}
```

------

## Utilizzo
<a name="log-manager-component-usage"></a>

Il componente log manager viene caricato nei seguenti gruppi di log e flussi di log.

------
#### [ 2.1.0 and later ]<a name="log-manager-log-group-stream-format"></a>

**Nome del gruppo di log**  

```
/aws/greengrass/componentType/region/componentName
```
Il nome del gruppo di log utilizza le seguenti variabili:  
+ `componentType`— Il tipo di componente, che può essere uno dei seguenti:
  + `GreengrassSystemComponent`— Questo gruppo di log include i log per i componenti del nucleo e del plugin, che vengono eseguiti nella stessa JVM del nucleo Greengrass. Il componente fa parte del nucleo [Greengrass](greengrass-nucleus-component.md).
  + `UserComponent`— Questo gruppo di log include i registri per componenti generici, componenti Lambda e altre applicazioni sul dispositivo. Il componente non fa parte del nucleo Greengrass.

  Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).
+ `region`— La AWS regione utilizzata dal dispositivo principale.
+ `componentName`— Il nome del componente. Per i registri di sistema, questo valore è`System`.

**Nome del flusso di log**  

```
/date/thing/thingName
```
Il nome del flusso di registro utilizza le seguenti variabili:  
+ `date`— La data del registro, ad esempio`2020/12/15`. Il componente log manager utilizza il `yyyy/MM/dd` formato.
+ `thingName`— Il nome del dispositivo principale.
Se il nome di un oggetto contiene due punti (`:`), il gestore dei registri sostituisce i due punti con un segno più (`+`).

------
#### [ 2.0.x ]

**Nome del gruppo di log**  

```
/aws/greengrass/componentType/region/componentName
```
Il nome del gruppo di log utilizza le seguenti variabili:  
+ `componentType`— Il tipo di componente, che può essere uno dei seguenti:
  + `GreengrassSystemComponent`— Il componente fa parte del nucleo [Greengrass](greengrass-nucleus-component.md).
  + `UserComponent`— Il componente non fa parte del nucleo Greengrass. Il gestore dei registri utilizza questo tipo per i componenti Greengrass e altre applicazioni sul dispositivo.
+ `region`— La AWS regione utilizzata dal dispositivo principale.
+ `componentName`— Il nome del componente. Per i registri di sistema, questo valore è`System`.

**Nome del flusso di log**  

```
/date/deploymentTargets/thingName
```
Il nome del flusso di registro utilizza le seguenti variabili:  
+ `date`— La data del registro, ad esempio`2020/12/15`. Il componente log manager utilizza il `yyyy/MM/dd` formato.
+ `deploymentTargets`— Le cose le cui distribuzioni includono il componente. Il componente log manager separa ogni destinazione con una barra. Se il componente viene eseguito sul dispositivo principale come risultato di una distribuzione locale, questo valore è. `LOCAL_DEPLOYMENT`

  Si consideri un esempio in cui si dispone di un dispositivo principale denominato `MyGreengrassCore` e il dispositivo principale ha due distribuzioni:
  + Una distribuzione destinata al dispositivo principale,. `MyGreengrassCore`
  + Una distribuzione destinata a un gruppo di oggetti denominato`MyGreengrassCoreGroup`, che contiene il dispositivo principale.

  I `deploymentTargets` per questo dispositivo principale sono`thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup`.
+ `thingName`— Il nome del dispositivo principale.

------

### Formati per le voci di registro.
<a name="log-manager-entry-format"></a>

Il nucleo Greengrass scrive i file di registro in formato stringa o JSON. Per i log di sistema, è possibile controllare il formato impostando il `format` campo della voce. `logging` Puoi trovare la `logging` voce nel file di configurazione del componente Greengrass nucleus. Per ulteriori informazioni, vedere [Greengrass nucleus](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration) configuration.

Il formato di testo è in formato libero e accetta qualsiasi stringa. Il seguente messaggio del servizio Fleet Status è un esempio di registrazione in formato stringa:

```
2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published. 
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService, 
currentState=RUNNING}
```

È necessario utilizzare il formato JSON se si desidera visualizzare i log con il comando Greengrass [CLI logs o interagire con i log a livello di codice.](https://docs.aws.amazon.com/greengrass/v2/developerguide/gg-cli-logs.html) L'esempio seguente delinea la forma JSON:

```
{
   "loggerName": <string>,
   "level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
   "eventType": <string, optional>,
   "cause": <string, optional>,
   "contexts": {},
   "thread": <string>,
   "message": <string>,
   "timestamp": <epoch time> # Needs to be epoch time
}
```

Per controllare l'output dei log del componente, puoi utilizzare l'`minimumLogLevel`opzione di configurazione. Per utilizzare questa opzione, il componente deve scrivere le sue voci di registro in formato JSON. È necessario utilizzare lo stesso formato del file di registro di sistema.

## File di registro locale
<a name="log-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="log-manager-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.3.11  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.10  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.9  |  Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.  | 
|  2.3.8  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.  | 
|  2.3.7  |  Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.  | 
|  2.3.6  |  <a name="changelog-log-manager-2.3.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.5  |  <a name="changelog-log-manager-2.3.5"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html) Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.  | 
|  2.3.4  |  <a name="changelog-log-manager-2.3.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.3  |  Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.  | 
|  2.3.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.3.0  |   Si consiglia di eseguire l'aggiornamento a Greengrass nucleus 2.9.1 quando si esegue l'aggiornamento a log manager 2.3.0.   [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.2.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.2.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.2.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.2.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.2.1  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  <a name="changelog-log-manager-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.1.0  |  <a name="changelog-log-manager-2.1.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/log-manager-component.html)  | 
|  2.0.x  |  Versione iniziale.  | 

# Componenti per l'apprendimento automatico
<a name="machine-learning-components"></a>

AWS IoT Greengrass fornisce i seguenti componenti di machine learning che puoi distribuire su dispositivi supportati per [eseguire inferenze di machine learning](perform-machine-learning-inference.md) utilizzando modelli addestrati in Amazon SageMaker AI o con i tuoi modelli pre-addestrati archiviati in Amazon S3. <a name="ml-component-types"></a>

AWS fornisce le seguenti categorie di componenti di apprendimento automatico:
+ **Componente del modello**: contiene modelli di apprendimento automatico come artefatti Greengrass.
+ **Componente Runtime**: contiene lo script che installa il framework di machine learning e le sue dipendenze sul dispositivo principale Greengrass.
+ **Componente di inferenza**: contiene il codice di inferenza e include le dipendenze dei componenti per installare il framework di machine learning e scaricare modelli di machine learning preaddestrati.

È possibile utilizzare il codice di inferenza di esempio e i modelli preaddestrati nei componenti di machine learning AWS forniti per eseguire la classificazione delle immagini e il rilevamento degli oggetti utilizzando DLR e Lite. TensorFlow Per eseguire inferenze di machine learning personalizzate con i tuoi modelli archiviati in Amazon S3 o per utilizzare un framework di machine learning diverso, puoi utilizzare le ricette di questi componenti pubblici come modelli per creare componenti di machine learning personalizzati. Per ulteriori informazioni, consulta [Personalizza i tuoi componenti di machine learning](ml-customization.md).

AWS IoT Greengrass include anche un componente AWS fornito per gestire l'installazione e il ciclo di vita dell'agente SageMaker AI Edge Manager sui dispositivi principali Greengrass. Con SageMaker AI Edge Manager, puoi utilizzare i modelli compilati da Amazon SageMaker AI NEO direttamente sul tuo dispositivo principale. Per ulteriori informazioni, consulta [Usa Amazon SageMaker AI Edge Manager sui dispositivi core Greengrass](use-sagemaker-edge-manager.md).

La tabella seguente elenca i componenti di machine learning disponibili in. AWS IoT Greengrass

**Nota**  <a name="component-nucleus-dependency-update-note"></a>
Diversi componenti AWS forniti dipendono da versioni minori specifiche del nucleo Greengrass. A causa di questa dipendenza, è necessario aggiornare questi componenti quando si aggiorna il nucleo di Greengrass a una nuova versione secondaria. Per informazioni sulle versioni specifiche del nucleo da cui dipende ogni componente, consultate l'argomento relativo ai componenti. Per ulteriori informazioni sull'aggiornamento del nucleo, vedere. [Aggiornamento del software AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md)

<a name="component-table-type-description"></a>Quando un componente ha un tipo di componente sia generico che Lambda, la versione corrente del componente è di tipo generico e una versione precedente del componente è di tipo Lambda.


| Componente | Description | [Tipo di componente](develop-greengrass-components.md#component-types) | Sistema operativo supportato | [Open source](open-source.md) | 
| --- | --- | --- | --- | --- | 
| [SageMaker Gestione AI Edge](sagemaker-edge-manager-component.md) | Implementa l'agente Amazon SageMaker AI Edge Manager sul dispositivo principale Greengrass. | Generico | Linux, Windows | No | 
| [Classificazione delle immagini DLR](dlr-image-classification-component.md) | Componente di inferenza che utilizza l'archivio del modello di classificazione delle immagini DLR e il componente runtime DLR come dipendenze per installare DLR, scaricare modelli di classificazione delle immagini di esempio ed eseguire inferenze di classificazione delle immagini sui dispositivi supportati. | Generico | Linux, Windows | No | 
| [Rilevamento di oggetti DLR](dlr-object-detection-component.md) | Componente di inferenza che utilizza l'archivio del modello di rilevamento degli oggetti DLR e il componente runtime DLR come dipendenze per installare DLR, scaricare modelli di rilevamento di oggetti di esempio ed eseguire inferenze per il rilevamento degli oggetti sui dispositivi supportati. | Generico | Linux, Windows | No | 
| [Archivio modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | Componente del modello che contiene esempi di modelli di classificazione delle immagini ResNet -50 come artefatti Greengrass. | Generico | Linux, Windows | No | 
| [Archivio modelli DLR per il rilevamento di oggetti](dlr-object-detection-model-store-component.md) | Componente del modello che contiene modelli di rilevamento di YOLOv3 oggetti di esempio come artefatti Greengrass. | Generico | Linux, Windows | No | 
| [Runtime DLR](dlr-component.md) | Componente di runtime che contiene uno script di installazione utilizzato per installare DLR e le sue dipendenze sul dispositivo principale Greengrass. | Generico | Linux, Windows | No | 
| [TensorFlow Classificazione delle immagini Lite](tensorflow-lite-image-classification-component.md) | Componente di inferenza che utilizza l' TensorFlow archivio del modello di classificazione delle immagini TensorFlow Lite e il componente runtime Lite come dipendenze per installare TensorFlow Lite, scaricare modelli di classificazione delle immagini di esempio ed eseguire inferenze di classificazione delle immagini sui dispositivi supportati. | Generico | Linux, Windows | No | 
| [TensorFlow Rilevamento di oggetti Lite](tensorflow-lite-object-detection-component.md) | Componente di inferenza che utilizza l'archivio del modello di rilevamento degli oggetti TensorFlow Lite e il componente runtime TensorFlow Lite come dipendenze per installare TensorFlow Lite, scaricare modelli di rilevamento di oggetti di esempio ed eseguire inferenze per il rilevamento degli oggetti sui dispositivi supportati. | Generico | Linux, Windows | No | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | Componente del modello che contiene un modello MobileNet v1 di esempio come artefatto Greengrass. | Generico | Linux, Windows | No | 
| [TensorFlow Archivio di modelli Lite per il rilevamento di oggetti](tensorflow-lite-object-detection-model-store-component.md) | Componente del modello che contiene un MobileNet modello di Single Shot Detection (SSD) di esempio come artefatto Greengrass. | Generico | Linux, Windows | No | 
| [TensorFlow Runtime Lite](tensorflow-lite-component.md) | Componente di runtime che contiene uno script di installazione utilizzato per installare TensorFlow Lite e le sue dipendenze sul dispositivo principale Greengrass. | Generico | Linux, Windows | No | 

# SageMaker Gestione AI Edge
<a name="sagemaker-edge-manager-component"></a>

**Importante**  
SageMaker AI Edge Manager è stato interrotto il 26 aprile 2024. Per ulteriori informazioni su come continuare a distribuire i tuoi modelli sui dispositivi edge, consulta la sezione End of life di [SageMaker AI Edge Manager](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-eol.html).

Il componente Amazon SageMaker AI Edge Manager (`aws.greengrass.SageMakerEdgeManager`) installa il binario dell'agente SageMaker AI Edge Manager. 

SageMaker AI Edge Manager fornisce la gestione dei modelli per i dispositivi edge in modo da poter ottimizzare, proteggere, monitorare e mantenere i modelli di machine learning su flotte di dispositivi edge. Il componente SageMaker AI Edge Manager installa e gestisce il ciclo di vita dell'agente SageMaker AI Edge Manager sul dispositivo principale. Puoi anche utilizzare SageMaker AI Edge Manager per impacchettare e utilizzare modelli compilati da SageMaker AI NEO come componenti del modello sui dispositivi core Greengrass. Per ulteriori informazioni sull'utilizzo dell'agente SageMaker AI Edge Manager sul dispositivo principale, consulta. [Usa Amazon SageMaker AI Edge Manager sui dispositivi core Greengrass](use-sagemaker-edge-manager.md)

SageMaker Il componente AI Edge Manager v1.3.x installa il binario dell'agente Edge Manager v1.20220822.836f3023. [Per ulteriori informazioni sulle versioni binarie dell'agente Edge Manager, vedere Edge Manager Agent.](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about)

**Nota**  
Il componente SageMaker AI Edge Manager è disponibile solo nei seguenti casi Regioni AWS:  
Stati Uniti orientali (Ohio)
Stati Uniti orientali (Virginia settentrionale)
Stati Uniti occidentali (Oregon)
UE (Francoforte)
UE (Irlanda)
Asia Pacifico (Tokyo)

**Topics**
+ [Versioni](#sagemaker-edge-manager-component-versions)
+ [Tipo](#sagemaker-edge-manager-component-type)
+ [Sistema operativo](#sagemaker-edge-manager-component-os-support)
+ [Requisiti](#sagemaker-edge-manager-component-requirements)
+ [Dipendenze](#sagemaker-edge-manager-component-dependencies)
+ [Configurazione](#sagemaker-edge-manager-component-configuration)
+ [File di registro locale](#sagemaker-edge-manager-component-log-file)
+ [Changelog](#sagemaker-edge-manager-component-changelog)

## Versioni
<a name="sagemaker-edge-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Tipo
<a name="sagemaker-edge-manager-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="sagemaker-edge-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="sagemaker-edge-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="sm-edge-manager-component-reqs"></a>
+ <a name="sm-req-core-device"></a>Un dispositivo core Greengrass in esecuzione su Amazon Linux 2, una piattaforma Linux basata su Debian (x86\$164 o Armv8) o Windows (x86\$164). Se non lo hai, consultare [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md).
+ <a name="sm-req-python"></a>[Python](https://www.python.org/downloads/) 3.6 o versione successiva, inclusa `pip` la tua versione di Python, installato sul tuo dispositivo principale.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) è configurato con quanto segue: 
  + <a name="sm-req-iam-trust-relationship"></a>Una relazione di fiducia che consente `credentials.iot.amazonaws.com` e consente `sagemaker.amazonaws.com` di assumere il ruolo, come illustrato nel seguente esempio di policy IAM.

    ```
    { 
      "Version": "2012-10-17",		 	 	 
      "Statement": [ 
        { 
          "Effect": "Allow", 
          "Principal": {
            "Service": "credentials.iot.amazonaws.com"
           }, 
          "Action": "sts:AssumeRole" 
        },
        { 
          "Effect": "Allow", 
          "Principal": {
            "Service": "sagemaker.amazonaws.com"
          }, 
          "Action": "sts:AssumeRole" 
        } 
      ] 
    }
    ```
  + <a name="sm-req-iam-sagemanakeredgedevicefleetpolicy"></a>La politica gestita da [AmazonSageMakerEdgeDeviceFleetPolicy](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AmazonSageMakerEdgeDeviceFleetPolicy)IAM.
  + <a name="sm-req-iam-s3-putobject"></a>L'`s3:PutObject`azione, come illustrato nel seguente esempio di policy IAM.

    ```
    {
      "Version": "2012-10-17",		 	 	 
      "Statement": [
        {
          "Action": [
            "s3:PutObject"
          ],
          "Resource": [
            "*"
          ],
          "Effect": "Allow"
        }
      ]
    }
    ```
+ <a name="sm-req-s3-bucket"></a>Un bucket Amazon S3 creato nello stesso Regione AWS dispositivo Account AWS principale Greengrass. SageMaker AI Edge Manager richiede un bucket S3 per creare una flotta di dispositivi edge e per archiviare dati di esempio derivanti dall'esecuzione dell'inferenza sul dispositivo. Per informazioni sulla creazione di bucket S3, consulta [Guida introduttiva ad Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html).
+ <a name="sm-req-edge-device-fleet"></a>Una flotta di dispositivi edge SageMaker AI che utilizza lo stesso alias di AWS IoT ruolo del dispositivo principale Greengrass. Per ulteriori informazioni, consulta [Crea una flotta di dispositivi edge](get-started-with-edge-manager-on-greengrass.md#create-edge-device-fleet-for-greengrass).
+ <a name="sm-req-edge-device"></a>Il tuo dispositivo principale Greengrass è stato registrato come dispositivo edge nella tua flotta di dispositivi SageMaker AI Edge. Il nome del dispositivo edge deve corrispondere al nome dell' AWS IoT oggetto del dispositivo principale. Per ulteriori informazioni, consulta [Registra il tuo dispositivo Greengrass core](get-started-with-edge-manager-on-greengrass.md#register-greengrass-core-device-in-sme).

### Endpoint e porte
<a name="sagemaker-edge-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `edge.sagemaker.region.amazonaws.com`  | 443 | Sì |  Controlla lo stato di registrazione del dispositivo e invia le metriche all'IA. SageMaker   | 
|  `*.s3.amazonaws.com`  | 443 | Sì |  Carica i dati di acquisizione nel bucket S3 che hai specificato. Puoi sostituirlo `*` con il nome di ogni bucket in cui carichi i dati.  | 

## Dipendenze
<a name="sagemaker-edge-manager-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#sagemaker-edge-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.3.5 and 1.3.6 ]

La tabella seguente elenca le dipendenze per le versioni 1.3.5 e 1.3.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.3.4 ]

La tabella seguente elenca le dipendenze per la versione 1.3.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.3.3 ]

La tabella seguente elenca le dipendenze per la versione 1.3.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.3.2 ]

La tabella seguente elenca le dipendenze per la versione 1.3.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.3.1 ]

La tabella seguente elenca le dipendenze per la versione 1.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.1.1 - 1.3.0 ]

La tabella seguente elenca le dipendenze per le versioni 1.1.1 - 1.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.1.0 ]

La tabella seguente elenca le dipendenze per la versione 1.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.0.3 ]

La tabella seguente elenca le dipendenze per la versione 1.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.0.1 and 1.0.2 ]

La tabella seguente elenca le dipendenze per le versioni 1.0.1 e 1.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------
#### [ 1.0.0 ]

La tabella seguente elenca le dipendenze per la versione 1.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=0.0.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="sagemaker-edge-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  
Questa sezione descrive i parametri di configurazione impostati nel componente. Per ulteriori informazioni sulla configurazione di SageMaker AI Edge Manager corrispondente, consulta [Edge Manager Agent](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about.html#edge-device-fleet-running-agent) nella *Amazon SageMaker AI Developer Guide*.

`DeviceFleetName`  
Il nome del parco dispositivi SageMaker AI Edge Manager che contiene il dispositivo principale Greengrass.   
È necessario specificare un valore per questo parametro nell'aggiornamento della configurazione quando si distribuisce questo componente.

`BucketName`  
Il nome del bucket S3 in cui carichi i dati di inferenza acquisiti. Il nome del bucket deve contenere la stringa. `sagemaker`   
Se si imposta su `CaptureDataDestination``Cloud`, o se si imposta su `CaptureDataPeriodicUpload``true`, è necessario specificare un valore per questo parametro nell'aggiornamento della configurazione quando si distribuisce questo componente.  
Capture data è una funzionalità di SageMaker intelligenza artificiale che utilizzi per caricare input di inferenza, risultati di inferenza e dati di inferenza aggiuntivi su un bucket S3 o una directory locale per analisi future. Per ulteriori informazioni sull'utilizzo dei dati di acquisizione con SageMaker AI Edge Manager, consulta [Manage Model](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-manage-model.html#edge-manage-model-capturedata) nella *Amazon SageMaker AI Developer Guide*.

`CaptureDataBatchSize`  
(Facoltativo) La dimensione di un batch di richieste di dati di acquisizione gestite dall'agente. Questo valore deve essere inferiore alla dimensione del buffer specificata. `CaptureDataBufferSize` Si consiglia di non superare la metà della dimensione del buffer.  
L'agente gestisce un batch di richieste quando il numero di richieste nel buffer raggiunge il `CaptureDataBatchSize` numero o allo scadere dell'`CaptureDataPushPeriodSeconds`intervallo, a seconda dell'evento che si verifica per primo.  
Impostazione predefinita: `10`

`CaptureDataBufferSize`  
(Facoltativo) Il numero massimo di richieste di dati di acquisizione archiviate nel buffer.  
Impostazione predefinita: `30`

`CaptureDataDestination`  
(Facoltativo) La destinazione in cui vengono archiviati i dati acquisiti. Questo parametro può avere uno dei seguenti valori:  
+ `Cloud`—Carica i dati acquisiti nel bucket S3 specificato dall'utente. `BucketName`
+ `Disk`—Scrive i dati acquisiti nella directory di lavoro del componente. 
Se lo specifichi`Disk`, puoi anche scegliere di caricare periodicamente i dati acquisiti nel tuo bucket S3 impostando su. `CaptureDataPeriodicUpload` `true`  
Impostazione predefinita: `Cloud`

`CaptureDataPeriodicUpload`  
(Facoltativo) Valore di stringa che specifica se caricare periodicamente i dati acquisiti. I valori supportati sono `true` e `false`.  
Imposta questo parametro su `true` se lo hai `CaptureDataDestination` impostato `Disk` e desideri inoltre che l'agente carichi periodicamente i dati acquisiti nel tuo bucket S3.  
Impostazione predefinita: `false`

`CaptureDataPeriodicUploadPeriodSeconds`  
(Facoltativo) L'intervallo in secondi con cui l'agente SageMaker AI Edge Manager carica i dati acquisiti nel bucket S3. Utilizzate questo parametro se lo impostate su. `CaptureDataPeriodicUpload` `true`  
Impostazione predefinita: `8`

`CaptureDataPushPeriodSeconds`  
(Facoltativo) L'intervallo in secondi in cui l'agente SageMaker AI Edge Manager gestisce un batch di richieste di acquisizione di dati dal buffer.   
L'agente gestisce un batch di richieste quando il numero di richieste nel buffer raggiunge il `CaptureDataBatchSize` numero o allo scadere dell'`CaptureDataPushPeriodSeconds`intervallo, a seconda dell'evento che si verifica per primo.  
Impostazione predefinita: `4`

`CaptureDataBase64EmbedLimit`  
(Facoltativo) La dimensione massima in byte dei dati acquisiti caricati dall'agente AI Edge Manager. SageMaker   
Impostazione predefinita: `3072`

`FolderPrefix`  
(Facoltativo) Il nome della cartella in cui l'agente scrive i dati acquisiti. Se `CaptureDataDestination` si imposta su`Disk`, l'agente crea la cartella nella directory specificata da`CaptureDataDiskPath`. Se lo `CaptureDataDestination` imposti su`Cloud`, o se lo `CaptureDataPeriodicUpload` imposti`true`, l'agente crea la cartella nel tuo bucket S3.   
Impostazione predefinita: `sme-capture`

`CaptureDataDiskPath`  
Questa funzionalità è disponibile nella versione 1.1.0 e successive del componente SageMaker AI Edge Manager.  
(Facoltativo) Il percorso della cartella in cui l'agente crea la cartella dei dati acquisiti. Se si imposta su `CaptureDataDestination``Disk`, l'agente crea la cartella dei dati acquisiti in questa directory. Se non specificate questo valore, l'agente crea la cartella dei dati acquisiti nella directory di lavoro del componente. Utilizzate il `FolderPrefix` parametro per specificare il nome della cartella dei dati acquisiti.  
Impostazione predefinita: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager/capture`

`LocalDataRootPath`  
Questa funzionalità è disponibile nella versione 1.2.0 e nelle versioni successive del componente SageMaker AI Edge Manager.  
(Facoltativo) Il percorso in cui questo componente memorizza i seguenti dati sul dispositivo principale:  
+ Il database locale per i dati di runtime se `DbEnable` impostato su`true`.
+ SageMaker Modelli compilati da AI NEO che questo componente scarica automaticamente quando lo `DeploymentEnable` imposti. `true`
Impostazione predefinita: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager`

`DbEnable`  
(Facoltativo) È possibile consentire a questo componente di archiviare i dati di runtime in un database locale per conservare i dati, nel caso in cui il componente si guasti o il dispositivo perda alimentazione.  
Questo database richiede 5 MB di spazio di archiviazione sul file system del dispositivo principale.  
Impostazione predefinita: `false`

`DeploymentEnable`  
Questa funzionalità è disponibile nella versione 1.2.0 e nelle versioni successive del componente SageMaker AI Edge Manager.  
(Facoltativo) Puoi abilitare questo componente per recuperare automaticamente i modelli compilati da SageMaker AI NEO da quelli caricati su Amazon S3. Dopo aver caricato un nuovo modello su Amazon S3, usa SageMaker AI Studio o l'API SageMaker AI per distribuire il nuovo modello su questo dispositivo principale. Quando abiliti questa funzionalità, puoi distribuire nuovi modelli sui dispositivi principali senza dover creare una distribuzione. AWS IoT Greengrass   
Per utilizzare questa funzionalità, è necessario impostare su`DbEnable`. `true` Questa funzionalità utilizza il database locale per tenere traccia dei modelli recuperati da. Cloud AWS
Impostazione predefinita: `false`

`DeploymentPollInterval`  
Questa funzionalità è disponibile nella versione 1.2.0 e successive del componente SageMaker AI Edge Manager.  
(Facoltativo) La quantità di tempo (in minuti) tra cui questo componente verifica la presenza di nuovi modelli da scaricare. Questa opzione si applica quando è impostata `DeploymentEnable` su`true`.  
Impostazione predefinita: `1440` (1 giorno)

`DLRBackendOptions`  
Questa funzionalità è disponibile nella versione 1.2.0 e successive del componente SageMaker AI Edge Manager.  
(Facoltativo) I flag di runtime DLR da impostare nel runtime DLR utilizzato da questo componente. È possibile impostare il seguente flag:  
+ `TVM_TENSORRT_CACHE_DIR`— Abilita la memorizzazione nella cache del modello TensorRT. Specificate un percorso assoluto per una cartella esistente con autorizzazioni di lettura/scrittura.
+ `TVM_TENSORRT_CACHE_DISK_SIZE_MB`— Assegna il limite superiore della cartella cache del modello TensorRT. Quando la dimensione della directory supera questo limite, i motori memorizzati nella cache che vengono utilizzati meno vengono eliminati. Il valore predefinito è 512 MB.
Ad esempio, puoi impostare questo parametro sul valore seguente per abilitare la memorizzazione nella cache del modello TensorRT e limitare la dimensione della cache a 800 MB.  

```
TVM_TENSORRT_CACHE_DIR=/data/secured_folder/trt/cache; TVM_TENSORRT_CACHE_DISK_SIZE_MB=800
```

`SagemakerEdgeLogVerbose`  
(Facoltativo) Valore di stringa che specifica se abilitare la registrazione di debug. I valori supportati sono `true` e `false`.  
Impostazione predefinita: `false`

`UnixSocketName`  
(Facoltativo) La posizione del descrittore del file socket SageMaker AI Edge Manager sul dispositivo principale.  
Impostazione predefinita: `/tmp/aws.greengrass.SageMakerEdgeManager.sock`

**Example Esempio: fusione e aggiornamento della configurazione**  
La seguente configurazione di esempio specifica che il dispositivo principale fa parte di *MyEdgeDeviceFleet* e che l'agente scrive i dati di acquisizione sia sul dispositivo che su un bucket S3. Questa configurazione consente anche la registrazione dei debug.  

```
{
    "DeviceFleetName": "MyEdgeDeviceFleet",
    "BucketName": "amzn-s3-demo-bucket",
    "CaptureDataDestination": "Disk",
    "CaptureDataPeriodicUpload": "true",
    "SagemakerEdgeLogVerbose": "true"    
}
```

## File di registro locale
<a name="sagemaker-edge-manager-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="sagemaker-edge-manager-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.3.6  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  1.3.5  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  1.3.4  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  1.3.3  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  1.3.2  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  1.3.1  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/sagemaker-edge-manager-component.html)  | 
|  1.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/sagemaker-edge-manager-component.html)  | 
|  1.1.1  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  1.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/sagemaker-edge-manager-component.html)  | 
|  1.0.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  1.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/sagemaker-edge-manager-component.html)  | 
|  1.0.1  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  1.0.0  |  Versione iniziale.  | 

# Classificazione delle immagini DLR
<a name="dlr-image-classification-component"></a>

Il componente di classificazione delle immagini DLR (`aws.greengrass.DLRImageClassification`) contiene un codice di inferenza di esempio per eseguire l'inferenza di classificazione delle immagini utilizzando i modelli [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) e resnet-50. Questo componente utilizza la variante [Archivio modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) e i [Runtime DLR](dlr-component.md) componenti come dipendenze per scaricare DLR e i modelli di esempio. 

Per utilizzare questo componente di inferenza con un modello DLR personalizzato, [create una versione personalizzata del componente dipendente del Model Store](ml-customization.md#override-public-model-store). Per utilizzare il proprio codice di inferenza personalizzato, è possibile utilizzare la ricetta di questo componente come modello per [creare](ml-customization.md#create-inference-component) un componente di inferenza personalizzato.

**Topics**
+ [Versioni](#dlr-image-classification-component-versions)
+ [Tipo](#dlr-image-classification-component-type)
+ [Sistema operativo](#dlr-image-classification-component-os-support)
+ [Requisiti](#dlr-image-classification-component-requirements)
+ [Dipendenze](#dlr-image-classification-component-dependencies)
+ [Configurazione](#dlr-image-classification-component-configuration)
+ [File di registro locale](#dlr-image-classification-component-log-file)
+ [Changelog](#dlr-image-classification-component-changelog)

## Versioni
<a name="dlr-image-classification-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2,0x

## Tipo
<a name="dlr-image-classification-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="dlr-image-classification-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="dlr-image-classification-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="dlr-image-classification-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#dlr-image-classification-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.13 and 2.1.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.13 e 2.1.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.12 ]

La tabella seguente elenca le dipendenze per la versione 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.4 - 2.1.5 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.4 a 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 
| [Archivio di modelli di classificazione delle immagini DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Flessibili | 
| Archivio di modelli di classificazione delle immagini DLR | \$12.0.0 | Rigidi | 
| DLR | \$11,3,0 | Flessibili | 

------

## Configurazione
<a name="dlr-image-classification-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare quando si distribuisce il componente.

------
#### [ 2.1.x ]

`accessControl`  
<a name="ml-config-accesscontrol-desc"></a>(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare messaggi nell'argomento delle notifiche predefinito.   
Impostazione predefinita:   

```
{
   "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.DLRImageClassification:mqttproxy:1": {
         "policyDescription": "Allows access to publish via topic ml/dlr/image-classification.",
         "operations": [
            "aws.greengrass#PublishToIoTCore"
         ],
         "resources": [
            "ml/dlr/image-classification"
         ]
      }
   }
}
```

`PublishResultsOnTopic`  
<a name="ml-config-publishresultsontopic-desc"></a>(Facoltativo) L'argomento su cui si desidera pubblicare i risultati dell'inferenza. Se modificate questo valore, dovete modificare anche il valore del `accessControl` parametro `resources` in modo che corrisponda al nome dell'argomento personalizzato.  
Impostazione predefinita: `ml/dlr/image-classification`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageDirectory`  
<a name="ml-config-imagedirectory-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo in cui i componenti di inferenza leggono le immagini. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui si ha read/write accesso.  
<a name="ml-config-imagedirectory-img-default"></a>Impostazione predefinita: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/`  
Se imposti il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`ImageName`  
<a name="ml-config-imagename-desc"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per effettuare una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` Per impostazione predefinita, il componente utilizza l'immagine di esempio nella directory delle immagini predefinita. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-img-default"></a>Impostazione predefinita: `cat.jpeg`  
Se si imposta il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    "armv7l": "DLR-resnet50-armv7l-cpu-ImageClassification",
    "aarch64": "DLR-resnet50-aarch64-cpu-ImageClassification",
    "x86_64": "DLR-resnet50-x86_64-cpu-ImageClassification",
    "windows": "DLR-resnet50-win-cpu-ImageClassification"
}
```

`UseCamera`  <a name="ml-config-usecamera"></a>
(Facoltativo) Valore di stringa che definisce se utilizzare le immagini di una fotocamera collegata al dispositivo principale Greengrass. I valori supportati sono `true` e `false`.  
Quando impostate questo valore su`true`, il codice di inferenza di esempio accede alla fotocamera del dispositivo ed esegue l'inferenza localmente sull'immagine acquisita. I valori dei `ImageDirectory` parametri `ImageName` and vengono ignorati. Assicuratevi che l'utente che esegue questo componente abbia read/write accesso alla posizione in cui la fotocamera memorizza le immagini acquisite.  
Impostazione predefinita: `false`  
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

------
#### [ 2.0.x ]

`MLRootPath`  <a name="ml-config-mlrootpath"></a>
<a name="ml-config-mlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sui dispositivi principali Linux in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-mlrootpath-default-dlr"></a>Impostazione predefinita: `/greengrass/v2/work/variant.DLR/greengrass_ml`  
<a name="ml-config-mlrootpath-default-tfl"></a>Impostazione predefinita: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageName`  
<a name="ml-config-imagename-desc-dlr-1.3.0"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` La posizione predefinita è`MLRootPath/images`. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-img-default"></a>Impostazione predefinita: `cat.jpeg`

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
armv7l: "DLR-resnet50-armv7l-cpu-ImageClassification"
x86_64: "DLR-resnet50-x86_64-cpu-ImageClassification"
```

------

## File di registro locale
<a name="dlr-image-classification-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.DLRImageClassification.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRImageClassification.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="dlr-image-classification-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.14  | Versione aggiornata per la release Greengrass nucleus 2.12.5. | 
|  2.1.13  | Versione aggiornata per Greengrass nucleus versione 2.12.0. | 
|  2.1.12  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.11  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.8  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.7  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.6  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.5  |  Componente rilasciato in tutto. Regioni AWS  | 
|  2.1.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. Questa versione non è disponibile in Europa (Londra) (). `eu-west-2`  | 
|  2.1.3  |  Versione aggiornata per Greengrass nucleus versione 2.3.0.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.1  |  <a name="changelog-dlr-image-classification-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-image-classification-component.html)  | 
|  2.0.4  |  Versione iniziale.  | 

# Rilevamento di oggetti DLR
<a name="dlr-object-detection-component"></a>

Il componente di rilevamento degli oggetti DLR (`aws.greengrass.DLRObjectDetection`) contiene un codice di inferenza di esempio per eseguire l'inferenza del rilevamento di oggetti utilizzando [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) e modelli preaddestrati di esempio. Questo componente utilizza la variante [Archivio modelli DLR per il rilevamento di oggetti](dlr-object-detection-model-store-component.md) e i [Runtime DLR](dlr-component.md) componenti come dipendenze per scaricare DLR e i modelli di esempio. 

Per utilizzare questo componente di inferenza con un modello DLR personalizzato, [create una versione personalizzata del componente dipendente del Model Store](ml-customization.md#override-public-model-store). Per utilizzare il proprio codice di inferenza personalizzato, è possibile utilizzare la ricetta di questo componente come modello per [creare](ml-customization.md#create-inference-component) un componente di inferenza personalizzato.

**Topics**
+ [Versioni](#dlr-object-detection-component-versions)
+ [Tipo](#dlr-object-detection-component-type)
+ [Sistema operativo](#dlr-object-detection-component-os-support)
+ [Requisiti](#dlr-object-detection-component-requirements)
+ [Dipendenze](#dlr-object-detection-component-dependencies)
+ [Configurazione](#dlr-object-detection-component-configuration)
+ [File di registro locale](#dlr-object-detection-component-log-file)
+ [Changelog](#dlr-object-detection-component-changelog)

## Versioni
<a name="dlr-object-detection-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2,0x

## Tipo
<a name="dlr-object-detection-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="dlr-object-detection-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="dlr-object-detection-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="dlr-object-detection-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#dlr-object-detection-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.13 and 2.1.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.13 e 2.1.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.12 ]

La tabella seguente elenca le dipendenze per la versione 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.4 - 2.1.5 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.4 a 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 
| [Archivio di modelli di rilevamento di oggetti DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Rigidi | 
| [DLR](dlr-component.md) | \$11.6.0 | Rigidi | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Flessibili | 
| Archivio di modelli di rilevamento di oggetti DLR | \$12.0.0 | Rigidi | 
| DLR | \$11,3,0 | Flessibili | 

------

## Configurazione
<a name="dlr-object-detection-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare quando si distribuisce il componente.

------
#### [ 2.1.x ]

`accessControl`  
<a name="ml-config-accesscontrol-desc"></a>(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare messaggi nell'argomento delle notifiche predefinito.   
Impostazione predefinita:   

```
{
   "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.DLRObjectDetection:mqttproxy:1": {
         "policyDescription": "Allows access to publish via topic ml/dlr/object-detection.",
         "operations": [
            "aws.greengrass#PublishToIoTCore"
         ],
         "resources": [
            "ml/dlr/object-detection"
         ]
      }
   }
}
```

`PublishResultsOnTopic`  
<a name="ml-config-publishresultsontopic-desc"></a>(Facoltativo) L'argomento su cui si desidera pubblicare i risultati dell'inferenza. Se modificate questo valore, dovete modificare anche il valore del `accessControl` parametro `resources` in modo che corrisponda al nome dell'argomento personalizzato.  
Impostazione predefinita: `ml/dlr/object-detection`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageDirectory`  
<a name="ml-config-imagedirectory-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo in cui i componenti di inferenza leggono le immagini. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui si ha read/write accesso.  
<a name="ml-config-imagedirectory-obj-default"></a>Impostazione predefinita: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/`  
Se imposti il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`ImageName`  
<a name="ml-config-imagename-desc"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per effettuare una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` Per impostazione predefinita, il componente utilizza l'immagine di esempio nella directory delle immagini predefinita. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-obj-default"></a>Impostazione predefinita: `objects.jpg`  
Se si imposta il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    "armv7l": "DLR-yolo3-armv7l-cpu-ObjectDetection",
    "aarch64": "DLR-yolo3-aarch64-gpu-ObjectDetection",
    "x86_64": "DLR-yolo3-x86_64-cpu-ObjectDetection",
    "windows": "DLR-resnet50-win-cpu-ObjectDetection"
}
```

`UseCamera`  <a name="ml-config-usecamera"></a>
(Facoltativo) Valore di stringa che definisce se utilizzare le immagini di una fotocamera collegata al dispositivo principale Greengrass. I valori supportati sono `true` e `false`.  
Quando impostate questo valore su`true`, il codice di inferenza di esempio accede alla fotocamera del dispositivo ed esegue l'inferenza localmente sull'immagine acquisita. I valori dei `ImageDirectory` parametri `ImageName` and vengono ignorati. Assicuratevi che l'utente che esegue questo componente abbia read/write accesso alla posizione in cui la fotocamera memorizza le immagini acquisite.  
Impostazione predefinita: `false`  
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

------
#### [ 2.0.x ]

`MLRootPath`  <a name="ml-config-mlrootpath"></a>
<a name="ml-config-mlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sui dispositivi principali Linux in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-mlrootpath-default-dlr"></a>Impostazione predefinita: `/greengrass/v2/work/variant.DLR/greengrass_ml`  
<a name="ml-config-mlrootpath-default-tfl"></a>Impostazione predefinita: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`

`Accelerator`  
Non modificare. Attualmente, l'unico valore supportato per l'acceleratore è`cpu`, poiché i modelli nei componenti del modello dipendente vengono compilati solo per l'acceleratore CPU.

`ImageName`  
<a name="ml-config-imagename-desc-dlr-1.3.0"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per una previsione di creazione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` La posizione predefinita è`MLRootPath/images`. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-obj-default"></a>Impostazione predefinita: `objects.jpg`

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    armv7l: "DLR-yolo3-armv7l-cpu-ObjectDetection",
    x86_64: "DLR-yolo3-x86_64-cpu-ObjectDetection"
}
```

------

## File di registro locale
<a name="dlr-object-detection-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="dlr-object-detection-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.14  | Versione aggiornata per la release Greengrass nucleus 2.12.5. | 
|  2.1.13  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.12  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.11  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.8  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.7  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.6  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.5  |  Componente rilasciato in tutto. Regioni AWS  | 
|  2.1.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. Questa versione non è disponibile in Europa (Londra) (). `eu-west-2`  | 
|  2.1.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.2  |  <a name="changelog-dlr-object-detection-2.1.2"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-object-detection-component.html)  | 
|  2.1.1  |  <a name="changelog-dlr-object-detection-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-object-detection-component.html)  | 
|  2.0.4  |  Versione iniziale.  | 

# Archivio modelli di classificazione delle immagini DLR
<a name="dlr-image-classification-model-store-component"></a>

L'archivio dei modelli di classificazione delle immagini DLR è un componente del modello di apprendimento automatico che contiene ResNet -50 modelli pre-addestrati come artefatti Greengrass. [I modelli pre-addestrati utilizzati in questo componente vengono recuperati da [GluonCV Model Zoo e compilati utilizzando AI Neo Deep Learning](https://cv.gluon.ai/model_zoo/index.html) Runtime. SageMaker ](https://github.com/neo-ai/neo-ai-dlr)

Il componente di inferenza per la [classificazione delle immagini DLR](dlr-image-classification-component.md) utilizza questo componente come dipendenza per l'origine del modello. Per utilizzare un modello DLR personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) di questo componente del modello e includete il modello personalizzato come elemento del componente. È possibile utilizzare la ricetta di questo componente come modello per creare componenti del modello personalizzati. 

**Nota**  
Il nome del componente di archiviazione del modello di classificazione delle immagini DLR varia a seconda della versione. Il nome del componente per la versione 2.1.x e versioni successive è. `variant.DLR.ImageClassification.ModelStore` Il nome del componente per la versione 2.0.x è. `variant.ImageClassification.ModelStore`

**Topics**
+ [Versioni](#dlr-image-classification-model-store-component-versions)
+ [Tipo](#dlr-image-classification-model-store-component-type)
+ [Sistema operativo](#dlr-image-classification-model-store-component-os-support)
+ [Requisiti](#dlr-image-classification-model-store-component-requirements)
+ [Dipendenze](#dlr-image-classification-model-store-component-dependencies)
+ [Configurazione](#dlr-image-classification-model-store-component-configuration)
+ [File di registro locale](#dlr-image-classification-model-store-component-log-file)
+ [Changelog](#dlr-image-classification-model-store-component-changelog)

## Versioni
<a name="dlr-image-classification-model-store-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x () `variant.DLR.ImageClassification.ModelStore` 
+ 2,0x () `variant.ImageClassification.ModelStore` 

## Tipo
<a name="dlr-image-classification-model-store-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="dlr-image-classification-model-store-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="dlr-image-classification-model-store-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="dlr-image-classification-model-store-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#dlr-image-classification-model-store-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.12 - 2.1.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.12 e 2.1.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Flessibili | 

------

## Configurazione
<a name="dlr-image-classification-model-store-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="dlr-image-classification-model-store-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="dlr-image-classification-model-store-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.13  | Versione aggiornata per la release Greengrass nucleus 2.12.5. | 
|  2.1.12  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.11  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.7  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.6  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html)  | 
|  2.1.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.1  |  <a name="changelog-dlr-image-classification-model-store-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html)  | 
|  2.0.4  |  Versione iniziale.  | 

# Archivio modelli DLR per il rilevamento di oggetti
<a name="dlr-object-detection-model-store-component"></a>

L'archivio modelli di rilevamento degli oggetti DLR è un componente del modello di apprendimento automatico che contiene YOLOv3 modelli pre-addestrati come artefatti Greengrass. [I modelli di esempio utilizzati in questo componente vengono recuperati da [GluonCV Model Zoo e compilati utilizzando AI Neo Deep Learning](https://cv.gluon.ai/model_zoo/index.html) Runtime. SageMaker ](https://github.com/neo-ai/neo-ai-dlr)

Il componente di inferenza per il [rilevamento degli oggetti DLR](dlr-object-detection-component.md) utilizza questo componente come dipendenza per l'origine del modello. Per utilizzare un modello DLR personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) di questo componente del modello e includete il modello personalizzato come elemento del componente. È possibile utilizzare la ricetta di questo componente come modello per creare componenti del modello personalizzati. 

**Nota**  
Il nome del componente DLR Object Detection Model Store varia a seconda della versione. Il nome del componente per la versione 2.1.x e le versioni successive è. `variant.DLR.ObjectDetection.ModelStore` Il nome del componente per la versione 2.0.x è. `variant.ObjectDetection.ModelStore`

**Topics**
+ [Versioni](#dlr-object-detection-model-store-component-versions)
+ [Tipo](#dlr-object-detection-model-store-component-type)
+ [Sistema operativo](#dlr-object-detection-model-store-component-os-support)
+ [Requisiti](#dlr-object-detection-model-store-component-requirements)
+ [Dipendenze](#dlr-object-detection-model-store-component-dependencies)
+ [Configurazione](#dlr-object-detection-model-store-component-configuration)
+ [File di registro locale](#dlr-object-detection-model-store-component-log-file)
+ [Changelog](#dlr-object-detection-model-store-component-changelog)

## Versioni
<a name="dlr-object-detection-model-store-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x 
+ 2,0x

## Tipo
<a name="dlr-object-detection-model-store-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="dlr-object-detection-model-store-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="dlr-object-detection-model-store-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="dlr-object-detection-model-store-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#dlr-object-detection-model-store-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.13 and 2.1.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.13 e 2.1.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.12 ]

La tabella seguente elenca le dipendenze per la versione 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.5 and 2.1.6 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.5 e 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Flessibili | 

------

## Configurazione
<a name="dlr-object-detection-model-store-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="dlr-object-detection-model-store-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="dlr-object-detection-model-store-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.14  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.13  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.12  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.11  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.8  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.7  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.6  |  Aggiunge un modello di CPU per risolvere un problema sui dispositivi Armv8 (). AArch64  | 
|  2.1.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html)  | 
|  2.1.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.1  |  <a name="changelog-dlr-object-detection-model-store-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html) | 
|  2.0.4  |  Versione iniziale.  | 

# Runtime DLR
<a name="dlr-component"></a>

Il componente runtime DLR (`variant.DLR`) contiene uno script che installa [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) (DLR) e le relative dipendenze in un ambiente virtuale sul dispositivo. I [Rilevamento di oggetti DLR](dlr-object-detection-component.md) componenti [Classificazione delle immagini DLR](dlr-image-classification-component.md) and utilizzano questo componente come dipendenza per l'installazione di DLR. La versione del componente 1.6.x installa DLR v1.6.0 e la versione del componente 1.3.x installa DLR v1.3.0. 

[Per utilizzare un runtime diverso, è possibile utilizzare la ricetta di questo componente come modello per creare un componente di machine learning personalizzato.](ml-customization.md) 

**Topics**
+ [Versioni](#dlr-component-versions)
+ [Tipo](#dlr-component-type)
+ [Sistema operativo](#dlr-component-os-support)
+ [Requisiti](#dlr-component-requirements)
+ [Dipendenze](#dlr-component-dependencies)
+ [Configurazione](#dlr-component-configuration)
+ [Utilizzo](#dlr-component-usage)
+ [File di registro locale](#dlr-component-log-file)
+ [Changelog](#dlr-component-changelog)

## Versioni
<a name="dlr-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.6.x
+ 1.3.x

## Tipo
<a name="dlr-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="dlr-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="dlr-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

### Endpoint e porte
<a name="dlr-component-endpoints"></a>

Per impostazione predefinita, questo componente utilizza uno script di installazione per installare i pacchetti utilizzando i `pip` comandi `apt``yum`,`brew`, e, a seconda della piattaforma utilizzata dal dispositivo principale. Questo componente deve essere in grado di eseguire le richieste in uscita verso vari indici e repository di pacchetti per eseguire lo script di installazione. Per consentire il traffico in uscita di questo componente attraverso un proxy o un firewall, è necessario identificare gli endpoint degli indici e degli archivi dei pacchetti a cui il dispositivo principale si connette per l'installazione.

Quando identificate gli endpoint necessari per lo script di installazione di questo componente, tenete presente quanto segue:
+ Gli endpoint dipendono dalla piattaforma del dispositivo principale. Ad esempio, un dispositivo principale che esegue Ubuntu utilizza `apt` anziché `yum` o`brew`. Inoltre, i dispositivi che utilizzano lo stesso indice di pacchetti potrebbero avere elenchi di sorgenti diversi, quindi potrebbero recuperare pacchetti da repository diversi.
+ Gli endpoint potrebbero differire tra più dispositivi che utilizzano lo stesso indice di pacchetti, poiché ogni dispositivo ha i propri elenchi di sorgenti che definiscono dove recuperare i pacchetti.
+ Gli endpoint potrebbero cambiare nel tempo. Ogni indice URLs dei pacchetti fornisce gli archivi in cui si scaricano i pacchetti e il proprietario di un pacchetto può modificare ciò che fornisce URLs l'indice dei pacchetti.

Per ulteriori informazioni sulle dipendenze installate da questo componente e su come disabilitare lo script di installazione, vedete il parametro di configurazione. [UseInstaller](#dlr-component-config-useinstaller-term)

Per ulteriori informazioni sugli endpoint e le porte necessari per il funzionamento di base, vedere. [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md)

## Dipendenze
<a name="dlr-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#dlr-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.6.11 - 1.6.16 ]

La tabella seguente elenca le dipendenze per le versioni da 1.6.11 a 1.6.16 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Flessibili | 

------
#### [ 1.6.10 ]

La tabella seguente elenca le dipendenze per la versione 1.6.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 1.6.9 ]

La tabella seguente elenca le dipendenze per la versione 1.6.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 1.6.8 ]

La tabella seguente elenca le dipendenze per la versione 1.6.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 1.6.6 and 1.6.7 ]

La tabella seguente elenca le dipendenze per le versioni 1.6.6 e 1.6.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 1.6.4 and 1.6.5 ]

La tabella seguente elenca le dipendenze per le versioni 1.6.4 e 1.6.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 1.6.3 ]

La tabella seguente elenca le dipendenze per la versione 1.6.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 1.6.2 ]

La tabella seguente elenca le dipendenze per la versione 1.6.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 1.6.1 ]

La tabella seguente elenca le dipendenze per la versione 1.6.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------
#### [ 1.3.x ]

La tabella seguente elenca le dipendenze per la versione 1.3.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="dlr-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`MLRootPath`  
<a name="ml-config-mlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sui dispositivi principali di Linux in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-mlrootpath-default-dlr"></a>Impostazione predefinita: `/greengrass/v2/work/variant.DLR/greengrass_ml`

`WindowsMLRootPath`  
Questa funzionalità è disponibile nella versione 1.6.6 e successive di questo componente.  
<a name="ml-config-windowsmlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo principale di Windows in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-windowsmlrootpath-default-dlr"></a>Impostazione predefinita: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml`

  `UseInstaller`   
<a name="ml-config-useinstaller-desc-dlr"></a>(Facoltativo) Valore di stringa che definisce se utilizzare lo script di installazione in questo componente per installare DLR e le relative dipendenze. I valori supportati sono `true` e `false`.   <a name="ml-config-useinstaller-libraries-dlr"></a>

Imposta questo valore su `false` se desideri utilizzare uno script personalizzato per l'installazione DLR o se desideri includere dipendenze di runtime in un'immagine Linux predefinita. Per utilizzare questo componente con i componenti di inferenza DLR AWS forniti, installate le seguenti librerie, comprese le eventuali dipendenze, e mettetele a disposizione dell'utente del sistema, ad esempio chi esegue i `ggc_user` componenti ML.
+ [Python](https://www.python.org/downloads/) 3.7 o successivo, incluso `pip` per la tua versione di Python.
+ [Deep](https://github.com/neo-ai/neo-ai-dlr) Learning Runtime v1.6.0
+ [NumPy](https://numpy.org/install/).
+ [OpenCV-Python](https://pypi.org/project/opencv-python/).
+ [SDK per dispositivi AWS IoT v2 per Python](https://github.com/aws/aws-iot-device-sdk-python-v2).
+ [AWS Python Common Runtime (CRT)](https://github.com/awslabs/aws-crt-python).
+ [Picamera (solo](https://picamera.readthedocs.io/en/release-1.13/) per dispositivi Raspberry Pi).
+ [`awscam`modulo](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (per AWS DeepLens dispositivi).
+ LibGL (per dispositivi Linux)
<a name="ml-config-useinstaller-default"></a>Impostazione predefinita: `true`

## Utilizzo
<a name="dlr-component-usage"></a>

Utilizzate questo componente con il parametro `UseInstaller` di configurazione impostato per `true` installare DLR e le sue dipendenze sul dispositivo. Il componente configura un ambiente virtuale sul dispositivo che include OpenCV NumPy e le librerie necessarie per DLR. 

**Nota**  <a name="ml-installer-component-usage-note"></a>
Lo script di installazione di questo componente installa anche le versioni più recenti delle librerie di sistema aggiuntive necessarie per configurare l'ambiente virtuale sul dispositivo e per utilizzare il framework di machine learning installato. Ciò potrebbe aggiornare le librerie di sistema esistenti sul dispositivo. Consulta la tabella seguente per l'elenco delle librerie installate da questo componente per ogni sistema operativo supportato. Se desiderate personalizzare questo processo di installazione, impostate il parametro di `UseInstaller` configurazione su e sviluppate il vostro script di installazione. `false`


| Platform (Piattaforma) | Librerie installate sul sistema del dispositivo | Librerie installate nell'ambiente virtuale | 
| --- | --- | --- | 
| Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel | 
| Amazon Linux 2 | mesa-libGL | Nessuno | 
| Ubuntu | wget | Nessuno | 

Quando distribuite il componente di inferenza, questo componente di runtime verifica innanzitutto se sul dispositivo sono già installati DLR e le relative dipendenze e, in caso contrario, li installa automaticamente. 

## File di registro locale
<a name="dlr-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/variant.DLR.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\variant.DLR.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/variant.DLR.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\variant.DLR.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="dlr-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.6.16  |  Versione aggiornata per Greengrass nucleus versione 2.12.5.  | 
|  1.6.12  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-component.html)  | 
|  1.6.11  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  1.6.10  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  1.6.9  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  1.6.8  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  1.6.7  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-component.html)  | 
|  1.6.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-component.html)  | 
|  1.6.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-component.html)  | 
|  1.6.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  1.6.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  1.6.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  1.6.1  |  <a name="changelog-dlr-1.6.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/dlr-component.html)  | 
|  1.3.2  |  Versione iniziale. Installa DLR v1.3.0.  | 

# TensorFlow Classificazione delle immagini Lite
<a name="tensorflow-lite-image-classification-component"></a>

Il componente di classificazione delle immagini TensorFlow Lite (`aws.greengrass.TensorFlowLiteImageClassification`) contiene un codice di inferenza di esempio per eseguire l'inferenza della classificazione delle immagini utilizzando il runtime [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) e un modello quantizzato MobileNet 1.0 pre-addestrato di esempio. Questo componente utilizza la variante [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) e [TensorFlow Runtime Lite](tensorflow-lite-component.md) i componenti come dipendenze per scaricare il runtime TensorFlow Lite e il modello di esempio.

Per utilizzare questo componente di inferenza con un modello TensorFlow Lite personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) del componente dipendente del Model Store. Per utilizzare il proprio codice di inferenza personalizzato, è possibile utilizzare la ricetta di questo componente come modello per [creare un](ml-customization.md#create-inference-component) componente di inferenza personalizzato.

**Topics**
+ [Versioni](#tensorflow-lite-image-classification-component-versions)
+ [Tipo](#tensorflow-lite-image-classification-component-type)
+ [Sistema operativo](#tensorflow-lite-image-classification-component-os-support)
+ [Requisiti](#tensorflow-lite-image-classification-component-requirements)
+ [Dipendenze](#tensorflow-lite-image-classification-component-dependencies)
+ [Configurazione](#tensorflow-lite-image-classification-component-configuration)
+ [File di registro locale](#tensorflow-lite-image-classification-component-log-file)
+ [Changelog](#tensorflow-lite-image-classification-component-changelog)

## Versioni
<a name="tensorflow-lite-image-classification-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x

## Tipo
<a name="tensorflow-lite-image-classification-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-image-classification-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-image-classification-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="tensorflow-lite-image-classification-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-image-classification-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 and 2.1.12 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.11 e 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------

## Configurazione
<a name="tensorflow-lite-image-classification-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`accessControl`  
<a name="ml-config-accesscontrol-desc"></a>(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare messaggi nell'argomento delle notifiche predefinito.   
Impostazione predefinita:   

```
{
   "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.TensorFlowLiteImageClassification:mqttproxy:1": {
         "policyDescription": "Allows access to publish via topic ml/tflite/image-classification.",
         "operations": [
            "aws.greengrass#PublishToIoTCore"
         ],
         "resources": [
            "ml/tflite/image-classification"
         ]
      }
   }
}
```

`PublishResultsOnTopic`  
<a name="ml-config-publishresultsontopic-desc"></a>(Facoltativo) L'argomento su cui si desidera pubblicare i risultati dell'inferenza. Se modificate questo valore, dovete modificare anche il valore del `accessControl` parametro `resources` in modo che corrisponda al nome dell'argomento personalizzato.  
Impostazione predefinita: `ml/tflite/image-classification`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageDirectory`  
<a name="ml-config-imagedirectory-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo in cui i componenti di inferenza leggono le immagini. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui si ha read/write accesso.  
<a name="ml-config-imagedirectory-img-default"></a>Impostazione predefinita: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/`  
Se imposti il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`ImageName`  
<a name="ml-config-imagename-desc"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per effettuare una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` Per impostazione predefinita, il componente utilizza l'immagine di esempio nella directory delle immagini predefinita. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-img-default"></a>Impostazione predefinita: `cat.jpeg`  
Se si imposta il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    "model": "TensorFlowLite-Mobilenet"
}
```

`UseCamera`  <a name="ml-config-usecamera"></a>
(Facoltativo) Valore di stringa che definisce se utilizzare le immagini di una fotocamera collegata al dispositivo principale Greengrass. I valori supportati sono `true` e `false`.  
Quando impostate questo valore su`true`, il codice di inferenza di esempio accede alla fotocamera del dispositivo ed esegue l'inferenza localmente sull'immagine acquisita. I valori dei `ImageDirectory` parametri `ImageName` and vengono ignorati. Assicuratevi che l'utente che esegue questo componente abbia read/write accesso alla posizione in cui la fotocamera memorizza le immagini acquisite.  
Impostazione predefinita: `false`  
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

## File di registro locale
<a name="tensorflow-lite-image-classification-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="tensorflow-lite-image-classification-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.12  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione iniziale.  | 

# TensorFlow Rilevamento di oggetti Lite
<a name="tensorflow-lite-object-detection-component"></a>

Il componente TensorFlow Lite object detection (`aws.greengrass.TensorFlowLiteObjectDetection`) contiene un codice di inferenza di esempio per eseguire l'inferenza del rilevamento di oggetti utilizzando [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) e un modello Single Shot Detection (SSD) 1.0 di esempio pre-addestrato. MobileNet Questo componente utilizza la variante [TensorFlow Archivio di modelli Lite per il rilevamento di oggetti](tensorflow-lite-object-detection-model-store-component.md) e i [TensorFlow Runtime Lite](tensorflow-lite-component.md) componenti come dipendenze per scaricare TensorFlow Lite e il modello di esempio. 

Per utilizzare questo componente di inferenza con un modello TensorFlow Lite personalizzato, puoi [creare una versione personalizzata](ml-customization.md#override-public-model-store) del componente dipendente del Model Store. Per utilizzare il tuo codice di inferenza personalizzato, usa la ricetta di questo componente come modello per [creare un](ml-customization.md#create-inference-component) componente di inferenza personalizzato.

**Topics**
+ [Versioni](#tensorflow-lite-object-detection-component-versions)
+ [Tipo](#tensorflow-lite-object-detection-component-type)
+ [Sistema operativo](#tensorflow-lite-object-detection-component-os-support)
+ [Requisiti](#tensorflow-lite-object-detection-component-requirements)
+ [Dipendenze](#tensorflow-lite-object-detection-component-dependencies)
+ [Configurazione](#tensorflow-lite-object-detection-component-configuration)
+ [File di registro locale](#tensorflow-lite-object-detection-component-log-file)
+ [Changelog](#tensorflow-lite-object-detection-component-changelog)

## Versioni
<a name="tensorflow-lite-object-detection-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x

## Tipo
<a name="tensorflow-lite-object-detection-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-object-detection-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-object-detection-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="tensorflow-lite-object-detection-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-object-detection-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 and 2.1.12 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.11 e 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 
| [TensorFlow Archivio di modelli di classificazione delle immagini Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Rigidi | 
| [TensorFlow Leggero](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Rigidi | 

------

## Configurazione
<a name="tensorflow-lite-object-detection-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`accessControl`  
<a name="ml-config-accesscontrol-desc"></a>(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare messaggi nell'argomento delle notifiche predefinito.   
Impostazione predefinita:   

```
{
   "aws.greengrass.ipc.mqttproxy": {
      "aws.greengrass.TensorFlowLiteObjectDetection:mqttproxy:1": {
         "policyDescription": "Allows access to publish via topic ml/tflite/object-detection.",
         "operations": [
            "aws.greengrass#PublishToIoTCore"
         ],
         "resources": [
            "ml/tflite/object-detection"
         ]
      }
   }
}
```

`PublishResultsOnTopic`  
<a name="ml-config-publishresultsontopic-desc"></a>(Facoltativo) L'argomento su cui si desidera pubblicare i risultati dell'inferenza. Se modificate questo valore, dovete modificare anche il valore del `accessControl` parametro `resources` in modo che corrisponda al nome dell'argomento personalizzato.  
Impostazione predefinita: `ml/tflite/object-detection`

`Accelerator`  <a name="ml-config-accelerator"></a>
L'acceleratore che desideri utilizzare. I valori supportati sono `cpu` e `gpu`.  
I modelli di esempio nel componente del modello dipendente supportano solo l'accelerazione della CPU. Per utilizzare l'accelerazione GPU con un modello personalizzato diverso, [create un componente del modello personalizzato per sovrascrivere il componente](ml-customization.md#override-public-model-store) del modello pubblico.  
Impostazione predefinita: `cpu`

`ImageDirectory`  
<a name="ml-config-imagedirectory-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo in cui i componenti di inferenza leggono le immagini. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui si ha read/write accesso.  
<a name="ml-config-imagedirectory-obj-default"></a>Impostazione predefinita: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/`  
Se imposti il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`ImageName`  
<a name="ml-config-imagename-desc"></a>(Facoltativo) Il nome dell'immagine che il componente di inferenza utilizza come input per effettuare una previsione. Il componente cerca l'immagine nella cartella specificata in. `ImageDirectory` Per impostazione predefinita, il componente utilizza l'immagine di esempio nella directory delle immagini predefinita. AWS IoT Greengrass supporta i seguenti formati di immagine: `jpeg``jpg`,`png`, e`npy`.   
<a name="ml-config-imagename-obj-default"></a>Impostazione predefinita: `objects.jpg`  
Se si imposta il valore di `UseCamera` to`true`, questo parametro di configurazione viene ignorato. 

`InferenceInterval`  <a name="ml-config-inferenceinterval"></a>
(Facoltativo) Il tempo in secondi tra ogni previsione effettuata dal codice di inferenza. Il codice di inferenza di esempio viene eseguito all'infinito e ripete le previsioni all'intervallo di tempo specificato. Ad esempio, è possibile impostare un intervallo più breve se si desidera utilizzare le immagini scattate da una fotocamera per la previsione in tempo reale.  
Impostazione predefinita: `3600`

`ModelResourceKey`  <a name="ml-config-modelresourcekey"></a>
<a name="ml-config-modelresourcekey-desc"></a>(Facoltativo) I modelli utilizzati nel componente del modello pubblico dipendente. Modificate questo parametro solo se sostituite il componente del modello pubblico con un componente personalizzato.   
Impostazione predefinita:  

```
{
    "model": "TensorFlowLite-SSD"
}
```

`UseCamera`  <a name="ml-config-usecamera"></a>
(Facoltativo) Valore di stringa che definisce se utilizzare le immagini di una fotocamera collegata al dispositivo principale Greengrass. I valori supportati sono `true` e `false`.  
Quando impostate questo valore su`true`, il codice di inferenza di esempio accede alla fotocamera del dispositivo ed esegue l'inferenza localmente sull'immagine acquisita. I valori dei `ImageDirectory` parametri `ImageName` and vengono ignorati. Assicuratevi che l'utente che esegue questo componente abbia read/write accesso alla posizione in cui la fotocamera memorizza le immagini acquisite.  
Impostazione predefinita: `false`  
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

**Nota**  <a name="ml-config-not-visible-note"></a>
Quando si visualizza la ricetta di questo componente, il parametro di `UseCamera` configurazione non viene visualizzato nella configurazione predefinita. Tuttavia, è possibile modificare il valore di questo parametro in un [aggiornamento di fusione della configurazione](update-component-configurations.md) quando si distribuisce il componente.   
Se impostate su `UseCamera``true`, dovete anche creare un collegamento simbolico per consentire al componente di inferenza di accedere alla telecamera dall'ambiente virtuale creato dal componente runtime. Per ulteriori informazioni sull'utilizzo di una telecamera con i componenti di inferenza di esempio, vedere. [Aggiornamento delle configurazioni dei componenti](ml-tutorial-image-classification-camera.md)

## File di registro locale
<a name="tensorflow-lite-object-detection-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="tensorflow-lite-object-detection-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.12  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  <a name="changelog-tensorflow-lite-object-detection-2.1.1"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/tensorflow-lite-object-detection-component.html)  | 
|  2.1.0  |  Versione iniziale.  | 

# TensorFlow Archivio di modelli di classificazione delle immagini Lite
<a name="tensorflow-lite-image-classification-model-store-component"></a>

Il modello di classificazione delle immagini TensorFlow Lite (`variant.TensorFlowLite.ImageClassification.ModelStore`) è un componente del modello di apprendimento automatico che contiene un modello MobileNet v1 pre-addestrato come artefatto Greengrass. [https://tfhub.dev/](https://tfhub.dev/)

Il componente di [TensorFlow Classificazione delle immagini Lite](tensorflow-lite-image-classification-component.md) inferenza utilizza questo componente come dipendenza per l'origine del modello. Per utilizzare un modello TensorFlow Lite personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) di questo componente del modello e includete il modello personalizzato come elemento del componente. È possibile utilizzare la ricetta di questo componente come modello per creare componenti del modello personalizzati. 

**Topics**
+ [Versioni](#tensorflow-lite-image-classification-model-store-component-versions)
+ [Tipo](#tensorflow-lite-image-classification-model-store-component-type)
+ [Sistema operativo](#tensorflow-lite-image-classification-model-store-component-os-support)
+ [Requisiti](#tensorflow-lite-image-classification-model-store-component-requirements)
+ [Dipendenze](#tensorflow-lite-image-classification-model-store-component-dependencies)
+ [Configurazione](#tensorflow-lite-image-classification-model-store-component-configuration)
+ [File di registro locale](#tensorflow-lite-image-classification-model-store-component-log-file)
+ [Changelog](#tensorflow-lite-image-classification-model-store-component-changelog)

## Versioni
<a name="tensorflow-lite-image-classification-model-store-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x

## Tipo
<a name="tensorflow-lite-image-classification-model-store-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-image-classification-model-store-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-image-classification-model-store-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="tensorflow-lite-image-classification-model-store-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-image-classification-model-store-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 and 2.1.12  ]

La tabella seguente elenca le dipendenze per le versioni 2.1.11 e 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------

## Configurazione
<a name="tensorflow-lite-image-classification-model-store-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="tensorflow-lite-image-classification-model-store-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="tensorflow-lite-image-classification-model-store-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.12  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione iniziale.  | 

# TensorFlow Archivio di modelli Lite per il rilevamento di oggetti
<a name="tensorflow-lite-object-detection-model-store-component"></a>

Il TensorFlow Lite object detection model store (`variant.TensorFlowLite.ObjectDetection.ModelStore`) è un componente del modello di machine learning che contiene un modello Single Shot Detection (SSD) pre-addestrato come MobileNet artefatto Greengrass. [https://tfhub.dev/](https://tfhub.dev/)

Il componente di inferenza per il [rilevamento degli oggetti TensorFlow Lite](tensorflow-lite-object-detection-component.md) utilizza questo componente come dipendenza per l'origine del modello. Per utilizzare un modello TensorFlow Lite personalizzato, [create una versione personalizzata](ml-customization.md#override-public-model-store) di questo componente del modello e includete il modello personalizzato come elemento del componente. È possibile utilizzare la ricetta di questo componente come modello per creare componenti del modello personalizzati. 

**Topics**
+ [Versioni](#tensorflow-lite-object-detection-model-store-component-versions)
+ [Tipo](#tensorflow-lite-object-detection-model-store-component-type)
+ [Sistema operativo](#tensorflow-lite-object-detection-model-store-component-os-support)
+ [Requisiti](#tensorflow-lite-object-detection-model-store-component-requirements)
+ [Dipendenze](#tensorflow-lite-object-detection-model-store-component-dependencies)
+ [Configurazione](#tensorflow-lite-object-detection-model-store-component-configuration)
+ [File di registro locale](#tensorflow-lite-object-detection-model-store-component-log-file)
+ [Changelog](#tensorflow-lite-object-detection-model-store-component-changelog)

## Versioni
<a name="tensorflow-lite-object-detection-model-store-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x

## Tipo
<a name="tensorflow-lite-object-detection-model-store-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-object-detection-model-store-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-object-detection-model-store-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

## Dipendenze
<a name="tensorflow-lite-object-detection-model-store-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-object-detection-model-store-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 and 2.1.12 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.11 e 2.1.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------

## Configurazione
<a name="tensorflow-lite-object-detection-model-store-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="tensorflow-lite-object-detection-model-store-component-log-file"></a>

Questo componente non emette registri.

## Changelog
<a name="tensorflow-lite-object-detection-model-store-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.1.12  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.1.11  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.6  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.5  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.4  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.1.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.1.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione iniziale.  | 

# TensorFlow Runtime Lite
<a name="tensorflow-lite-component"></a>

Il componente runtime TensorFlow Lite (`variant.TensorFlowLite`) contiene uno script che installa la versione [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) 2.5.0 e le relative dipendenze in un ambiente virtuale sul dispositivo. Il componente [TensorFlow Lite per la classificazione delle immagini](tensorflow-lite-image-classification-component.md) e il [rilevamento degli oggetti TensorFlow Lite](tensorflow-lite-object-detection-component.md) utilizzano questo componente di runtime come dipendenza per l'installazione di Lite. TensorFlow 

**Nota**  
TensorFlow Il componente di runtime Lite v2.5.6 e versioni successive reinstalla le installazioni esistenti del runtime Lite e delle TensorFlow sue dipendenze. Questa reinstallazione aiuta a garantire che il dispositivo principale esegua versioni compatibili di Lite e delle sue dipendenze. TensorFlow 

Per utilizzare un runtime diverso, puoi utilizzare la ricetta di questo componente come modello per [creare un componente di apprendimento automatico personalizzato](ml-customization.md).

**Topics**
+ [Versioni](#tensorflow-lite-component-versions)
+ [Tipo](#tensorflow-lite-component-type)
+ [Sistema operativo](#tensorflow-lite-component-os-support)
+ [Requisiti](#tensorflow-lite-component-requirements)
+ [Dipendenze](#tensorflow-lite-component-dependencies)
+ [Configurazione](#tensorflow-lite-component-configuration)
+ [Utilizzo](#tensorflow-lite-component-usage)
+ [File di registro locale](#tensorflow-lite-component-log-file)
+ [Changelog](#tensorflow-lite-component-changelog)

## Versioni
<a name="tensorflow-lite-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.5.x

## Tipo
<a name="tensorflow-lite-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="tensorflow-lite-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="tensorflow-lite-component-requirements"></a>

Questo componente presenta i seguenti requisiti:<a name="ml-component-requirements"></a>
+ Sui dispositivi core Greengrass che eseguono Amazon Linux 2 o Ubuntu 18.04, sul dispositivo è installata la versione 2.27 o successiva della [GNU C Library](https://www.gnu.org/software/libc/) (glibc).
+ Sui dispositivi ARMv7L, come Raspberry Pi, le dipendenze per OpenCV-Python sono installate sul dispositivo. Esegui il comando seguente per installare le dipendenze.

  ```
  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
  ```
+ I dispositivi Raspberry Pi che eseguono il sistema operativo Raspberry Pi Bullseye devono soddisfare i seguenti requisiti:
  + NumPy 1.22.4 o versione successiva installata sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include una versione precedente di NumPy, quindi è possibile eseguire il seguente comando per l'aggiornamento del dispositivo. NumPy 

    ```
    pip3 install --upgrade numpy
    ```
  + Lo stack di fotocamere legacy è abilitato sul dispositivo. Il sistema operativo Raspberry Pi Bullseye include un nuovo stack di fotocamere abilitato di default e non compatibile, quindi è necessario abilitare lo stack di fotocamere precedente.<a name="raspberry-pi-bullseye-enable-legacy-camera-stack"></a>

**Per abilitare lo stack di telecamere precedente**

    1. Esegui il seguente comando per aprire lo strumento di configurazione Raspberry Pi.

       ```
       sudo raspi-config
       ```

    1. Seleziona **Opzioni di interfaccia**.

    1. Seleziona **Legacy camera** per abilitare lo stack di telecamere legacy.

    1. Riavvia il dispositivo Raspberry Pi.

### Endpoint e porte
<a name="tensorflow-lite-component-endpoints"></a>

Per impostazione predefinita, questo componente utilizza uno script di installazione per installare i pacchetti utilizzando i `pip` comandi `apt``yum`,`brew`, e, a seconda della piattaforma utilizzata dal dispositivo principale. Questo componente deve essere in grado di eseguire le richieste in uscita verso vari indici e repository di pacchetti per eseguire lo script di installazione. Per consentire il traffico in uscita di questo componente attraverso un proxy o un firewall, è necessario identificare gli endpoint degli indici e degli archivi dei pacchetti a cui il dispositivo principale si connette per l'installazione.

Quando identificate gli endpoint necessari per lo script di installazione di questo componente, tenete presente quanto segue:
+ Gli endpoint dipendono dalla piattaforma del dispositivo principale. Ad esempio, un dispositivo principale che esegue Ubuntu utilizza `apt` anziché `yum` o`brew`. Inoltre, i dispositivi che utilizzano lo stesso indice di pacchetti potrebbero avere elenchi di sorgenti diversi, quindi potrebbero recuperare pacchetti da repository diversi.
+ Gli endpoint potrebbero differire tra più dispositivi che utilizzano lo stesso indice di pacchetti, poiché ogni dispositivo ha i propri elenchi di sorgenti che definiscono dove recuperare i pacchetti.
+ Gli endpoint potrebbero cambiare nel tempo. Ogni indice URLs dei pacchetti fornisce gli archivi in cui si scaricano i pacchetti e il proprietario di un pacchetto può modificare ciò che fornisce URLs l'indice dei pacchetti.

Per ulteriori informazioni sulle dipendenze installate da questo componente e su come disabilitare lo script di installazione, vedete il parametro di configurazione. [UseInstaller](#tensorflow-lite-component-config-useinstaller-term)

Per ulteriori informazioni sugli endpoint e le porte necessari per il funzionamento di base, vedere. [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md)

## Dipendenze
<a name="tensorflow-lite-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#tensorflow-lite-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.5.14 and 2.5.15 ]

La tabella seguente elenca le dipendenze per le versioni 2.5.14 e 2.5.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flessibili | 

------
#### [ 2.5.13 ]

La tabella seguente elenca le dipendenze per la versione 2.5.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flessibili | 

------
#### [ 2.5.12 ]

La tabella seguente elenca le dipendenze per la versione 2.5.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flessibili | 

------
#### [ 2.5.11 ]

La tabella seguente elenca le dipendenze per la versione 2.5.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flessibili | 

------
#### [ 2.5.10 ]

La tabella seguente elenca le dipendenze per la versione 2.5.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flessibili | 

------
#### [ 2.5.9 ]

La tabella seguente elenca le dipendenze per la versione 2.5.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flessibili | 

------
#### [ 2.5.8 ]

La tabella seguente elenca le dipendenze per la versione 2.5.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flessibili | 

------
#### [ 2.5.5 - 2.5.7 ]

La tabella seguente elenca le dipendenze per le versioni da 2.5.5 a 2.5.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flessibili | 

------
#### [ 2.5.3 and 2.5.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.5.3 e 2.5.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flessibili | 

------
#### [ 2.5.2 ]

La tabella seguente elenca le dipendenze per la versione 2.5.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flessibili | 

------
#### [ 2.5.1 ]

La tabella seguente elenca le dipendenze per la versione 2.5.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flessibili | 

------
#### [ 2.5.0 ]

La tabella seguente elenca le dipendenze per la versione 2.5.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="tensorflow-lite-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`MLRootPath`  
<a name="ml-config-mlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sui dispositivi principali di Linux in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-mlrootpath-default-tfl"></a>Impostazione predefinita: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`

`WindowsMLRootPath`  
Questa funzionalità è disponibile nella versione 1.6.6 e successive di questo componente.  
<a name="ml-config-windowsmlrootpath-desc"></a>(Facoltativo) Il percorso della cartella sul dispositivo principale di Windows in cui i componenti di inferenza leggono le immagini e scrivono i risultati dell'inferenza. È possibile modificare questo valore in qualsiasi posizione del dispositivo a cui ha read/write accesso l'utente che esegue questo componente.  
<a name="ml-config-windowsmlrootpath-default-dlr"></a>Impostazione predefinita: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml`

  `UseInstaller`   
<a name="ml-config-useinstaller-desc-tfl"></a>(Facoltativo) Valore di stringa che definisce se utilizzare lo script di installazione in questo componente per installare TensorFlow Lite e le sue dipendenze. I valori supportati sono `true` e `false`.   <a name="ml-config-useinstaller-libraries-tfl"></a>

Imposta questo valore su `false` se desideri utilizzare uno script personalizzato per l'installazione di TensorFlow Lite o se desideri includere dipendenze di runtime in un'immagine Linux predefinita. Per utilizzare questo componente con i componenti di inferenza TensorFlow Lite AWS forniti, installa le seguenti librerie, comprese le eventuali dipendenze, e rendile disponibili all'utente del sistema, ad esempio chi esegue i componenti `ggc_user` ML.
+ [Python](https://www.python.org/downloads/) 3.8 o successivo, incluso `pip` per la tua versione di Python
+ [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) v2.5.0
+ [NumPy](https://numpy.org/install/)
+ [OpenCV-Python](https://pypi.org/project/opencv-python/)
+ [SDK per dispositivi AWS IoT v2 per Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS Python Common Runtime (CRT)](https://github.com/awslabs/aws-crt-python)
+ [Picamera](https://picamera.readthedocs.io/en/release-1.13/) (per dispositivi Raspberry Pi)
+ [`awscam`modulo](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (per AWS DeepLens dispositivi)
+ LibGL (per dispositivi Linux)
<a name="ml-config-useinstaller-default"></a>Impostazione predefinita: `true`

## Utilizzo
<a name="tensorflow-lite-component-usage"></a>

Utilizzate questo componente con il parametro `UseInstaller` di configurazione impostato per `true` installare TensorFlow Lite e le sue dipendenze sul dispositivo. Il componente configura un ambiente virtuale sul dispositivo che include OpenCV NumPy e le librerie necessarie per Lite. TensorFlow 

**Nota**  <a name="ml-installer-component-usage-note"></a>
Lo script di installazione di questo componente installa anche le versioni più recenti di librerie di sistema aggiuntive necessarie per configurare l'ambiente virtuale sul dispositivo e per utilizzare il framework di machine learning installato. Ciò potrebbe aggiornare le librerie di sistema esistenti sul dispositivo. Consulta la tabella seguente per l'elenco delle librerie installate da questo componente per ogni sistema operativo supportato. Se desiderate personalizzare questo processo di installazione, impostate il parametro di `UseInstaller` configurazione su e sviluppate il vostro script di installazione. `false`


| Platform (Piattaforma) | Librerie installate sul sistema del dispositivo | Librerie installate nell'ambiente virtuale | 
| --- | --- | --- | 
| Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel | 
| Amazon Linux 2 | mesa-libGL | Nessuno | 
| Ubuntu | wget | Nessuno | 

Quando si distribuisce il componente di inferenza, questo componente di runtime verifica innanzitutto se sul dispositivo sono già installati TensorFlow Lite e le relative dipendenze. In caso contrario, il componente di runtime li installa automaticamente. 

## File di registro locale
<a name="tensorflow-lite-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/variant.TensorFlowLite.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\variant.TensorFlowLite.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/variant.TensorFlowLite.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\variant.TensorFlowLite.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="tensorflow-lite-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.5.15  |  Versione aggiornata per la release Greengrass nucleus 2.12.5.  | 
|  2.5.14  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.5.13  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.5.12  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.5.11  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.5.10  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.5.9  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.5.8  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.5.7  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/tensorflow-lite-component.html)  | 
|  2.5.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/tensorflow-lite-component.html)  | 
|  2.5.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/tensorflow-lite-component.html)  | 
|  2.5.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/tensorflow-lite-component.html)  | 
|  2.5.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.5.2  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.5.1  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.5.0  |  Versione iniziale.  | 

# Adattatore di protocollo Modbus-RTU
<a name="modbus-rtu-protocol-adapter-component"></a>

Il componente dell'adattatore di protocollo Modbus-RTU (`aws.greengrass.Modbus`) raccoglie informazioni dai dispositivi Modbus RTU locali.

Per richiedere informazioni da un dispositivo Modbus RTU locale con questo componente, pubblica un messaggio sull'argomento a cui questo componente è abbonato. Nel messaggio, specificate la richiesta Modbus RTU da inviare a un dispositivo. Quindi, questo componente pubblica una risposta che contiene il risultato della richiesta Modbus RTU.

**Nota**  
Questo componente offre funzionalità simili al connettore dell'adattatore di protocollo Modbus RTU in V1. AWS IoT Greengrass *Per ulteriori informazioni, consulta il [connettore dell'adattatore di protocollo Modbus RTU](https://docs.aws.amazon.com/greengrass/latest/developerguide/modbus-protocol-adapter-connector.html) nella V1 Developer Guide.AWS IoT Greengrass *

**Topics**
+ [Versioni](#modbus-rtu-protocol-adapter-component-versions)
+ [Tipo](#modbus-rtu-protocol-adapter-component-type)
+ [Sistema operativo](#modbus-rtu-protocol-adapter-component-os-support)
+ [Requisiti](#modbus-rtu-protocol-adapter-component-requirements)
+ [Dipendenze](#modbus-rtu-protocol-adapter-component-dependencies)
+ [Configurazione](#modbus-rtu-protocol-adapter-component-configuration)
+ [Dati di input](#modbus-rtu-protocol-adapter-component-input-data)
+ [Dati di output](#modbus-rtu-protocol-adapter-component-output-data)
+ [Richieste e risposte RTU Modbus](#modbus-rtu-protocol-adapter-component-requests-responses)
+ [File di registro locale](#modbus-rtu-protocol-adapter-component-log-file)
+ [Licenze](#modbus-rtu-protocol-adapter-component-licenses)
+ [Changelog](#modbus-rtu-protocol-adapter-component-changelog)

## Versioni
<a name="modbus-rtu-protocol-adapter-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2,0x

## Tipo
<a name="modbus-rtu-protocol-adapter-component-type"></a>

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a>componente è un componente Lambda () `aws.greengrass.lambda`. [Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.](lambda-launcher-component.md)

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="modbus-rtu-protocol-adapter-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="modbus-rtu-protocol-adapter-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Una connessione fisica tra il dispositivo AWS IoT Greengrass principale e i dispositivi Modbus. Il dispositivo principale deve essere collegato fisicamente alla rete Modbus RTU tramite una porta seriale, ad esempio una porta USB.
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il componente [legacy del router di abbonamento (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente](legacy-subscription-router-component.md). Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-modbus": {
        "id": "aws-greengrass-modbus",
        "source": "component:aws.greengrass.Modbus",
        "subject": "modbus/adapter/response",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-modbus": {
        "id": "aws-greengrass-modbus",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-modbus:version",
        "subject": "modbus/adapter/response",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sostituiscilo con quello Regione AWS che usi.
  + Sostituisci *version* con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass) e cerca la coppia chiave-valore della **funzione Lambda**. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di abbonamento legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).
+ L'adattatore di protocollo Modbus-RTU è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="modbus-rtu-protocol-adapter-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#modbus-rtu-protocol-adapter-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.11 ]

La tabella seguente elenca le dipendenze per la versione 2.1.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 and 2.1.5 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.4 e 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 and 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.8 e 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | >=1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="modbus-rtu-protocol-adapter-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

------
#### [ v2.1.x ]

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`ModbusLocalPort`  <a name="modbus-rtu-protocol-adapter-configuration-modbuslocalport"></a>
Il percorso assoluto verso la porta seriale Modbus fisica sul dispositivo principale, ad esempio`/dev/ttyS2`.  
Per eseguire questo componente in un contenitore, è necessario definire questo percorso come dispositivo di sistema (in`containerParams.devices`) a cui il componente può accedere. Per impostazione predefinita, questo componente viene eseguito in un contenitore.  
Questo componente deve avere read/write accesso al dispositivo.  
`ModbusBaudRate`  
(Facoltativo) Un valore di stringa che specifica la velocità di trasmissione per la comunicazione seriale con i dispositivi Modbus TCP locali.  
Impostazione predefinita: `9600`  
`ModbusByteSize`  
(Facoltativo) Un valore di stringa che specifica la dimensione di un byte nella comunicazione seriale con dispositivi Modbus TCP locali. Scegliete`5`,`6`, o bit`7`. `8`  
Impostazione predefinita: `8`  
`ModbusParity`  
(Facoltativo) La modalità di parità da utilizzare per verificare l'integrità dei dati nella comunicazione seriale con dispositivi Modbus TCP locali.  
+ `E`— Verifica l'integrità dei dati con parità uniforme.
+ `O`— Verifica l'integrità dei dati con parità dispari.
+ `N`— Non verificate l'integrità dei dati.
Impostazione predefinita: `N`  
`ModbusStopBits`  
(Facoltativo) Un valore di stringa che specifica il numero di bit che indicano la fine di un byte nella comunicazione seriale con dispositivi Modbus TCP locali.  
Impostazione predefinita: `1`

`containerMode`  <a name="modbus-rtu-protocol-adapter-configuration-containermode"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.

  Se si specifica questa opzione, è necessario specificare un dispositivo di sistema (in`containerParams.devices`) per consentire al contenitore di accedere al dispositivo Modbus.
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  <a name="modbus-rtu-protocol-adapter-configuration-containerparams"></a>
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 512 MB (525.312 KB).  
`devices`  
(Facoltativo) Un oggetto che specifica i dispositivi di sistema a cui il componente può accedere in un contenitore.  
Per eseguire questo componente in un contenitore, è necessario specificare il dispositivo di sistema configurato nella variabile di `ModbusLocalPort` ambiente.
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`path`  
Il percorso del dispositivo di sistema sul dispositivo principale. Deve avere lo stesso valore del valore per cui è stato configurato`ModbusLocalPort`.  
`permission`  
(Facoltativo) L'autorizzazione ad accedere al dispositivo di sistema dal contenitore. Questo valore deve essere`rw`, che specifica che il componente ha read/write accesso al dispositivo di sistema.  
Impostazione predefinita: `rw`  
`addGroupOwner`  
(Facoltativo) Se aggiungere o meno il gruppo di sistema che esegue il componente come proprietario del dispositivo di sistema.  
Impostazione predefinita: `true`

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente si iscrive per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`and`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  <a name="modbus-rtu-protocol-adapter-configuration-example-container-mode"></a>

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "ModbusLocalPort": "/dev/ttyS2"
    }
  },
  "containerMode": "GreengrassContainer",
  "containerParams": {
    "devices": {
      "0": {
        "path": "/dev/ttyS2",
        "permission": "rw",
        "addGroupOwner": true
      }
    }
  }
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  <a name="modbus-rtu-protocol-adapter-configuration-example-no-container-mode"></a>

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "ModbusLocalPort": "/dev/ttyS2"
    }
  },
  "containerMode": "NoContainer"
}
```

------
#### [ v2.0.x ]

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`ModbusLocalPort`  <a name="modbus-rtu-protocol-adapter-configuration-modbuslocalport"></a>
Il percorso assoluto verso la porta seriale Modbus fisica sul dispositivo principale, ad esempio`/dev/ttyS2`.  
Per eseguire questo componente in un contenitore, è necessario definire questo percorso come dispositivo di sistema (in`containerParams.devices`) a cui il componente può accedere. Per impostazione predefinita, questo componente viene eseguito in un contenitore.  
Questo componente deve avere read/write accesso al dispositivo.

`containerMode`  <a name="modbus-rtu-protocol-adapter-configuration-containermode"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.

  Se si specifica questa opzione, è necessario specificare un dispositivo di sistema (in`containerParams.devices`) per consentire al contenitore di accedere al dispositivo Modbus.
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  <a name="modbus-rtu-protocol-adapter-configuration-containerparams"></a>
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 512 MB (525.312 KB).  
`devices`  
(Facoltativo) Un oggetto che specifica i dispositivi di sistema a cui il componente può accedere in un contenitore.  
Per eseguire questo componente in un contenitore, è necessario specificare il dispositivo di sistema configurato nella variabile di `ModbusLocalPort` ambiente.
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`path`  
Il percorso del dispositivo di sistema sul dispositivo principale. Deve avere lo stesso valore del valore per cui è stato configurato`ModbusLocalPort`.  
`permission`  
(Facoltativo) L'autorizzazione ad accedere al dispositivo di sistema dal contenitore. Questo valore deve essere`rw`, che specifica che il componente ha read/write accesso al dispositivo di sistema.  
Impostazione predefinita: `rw`  
`addGroupOwner`  
(Facoltativo) Se aggiungere o meno il gruppo di sistema che esegue il componente come proprietario del dispositivo di sistema.  
Impostazione predefinita: `true`

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente si iscrive per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`and`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  <a name="modbus-rtu-protocol-adapter-configuration-example-container-mode"></a>

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "ModbusLocalPort": "/dev/ttyS2"
    }
  },
  "containerMode": "GreengrassContainer",
  "containerParams": {
    "devices": {
      "0": {
        "path": "/dev/ttyS2",
        "permission": "rw",
        "addGroupOwner": true
      }
    }
  }
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  <a name="modbus-rtu-protocol-adapter-configuration-example-no-container-mode"></a>

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "ModbusLocalPort": "/dev/ttyS2"
    }
  },
  "containerMode": "NoContainer"
}
```

------

## Dati di input
<a name="modbus-rtu-protocol-adapter-component-input-data"></a>

Questo componente accetta i parametri di richiesta Modbus RTU sul seguente argomento e invia la richiesta Modbus RTU al dispositivo. <a name="connector-component-local-publish"></a>Per impostazione predefinita, questo componente si iscrive ai messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md). 

**Argomento predefinito (pubblicazione/sottoscrizione locale):** `modbus/adapter/request`

<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.

`request`  
I parametri per la richiesta Modbus RTU da inviare.  
La forma del messaggio di richiesta dipende dal tipo di richiesta Modbus RTU che rappresenta. Le seguenti proprietà sono obbligatorie per tutte le richieste.  
Tipo: `object` che contiene le seguenti informazioni:    
`operation`  
Il nome dell'operazione da eseguire. Ad esempio, specificate `ReadCoilsRequest` di leggere le bobine su un dispositivo Modbus RTU. Per ulteriori informazioni sulle operazioni supportate, vedere. [Richieste e risposte RTU Modbus](#modbus-rtu-protocol-adapter-component-requests-responses)  
Tipo: `string`  
`device`  
Il dispositivo di destinazione della richiesta.  
Questo valore deve essere un numero intero compreso tra `0` e`247`.  
Tipo: `integer`
Gli altri parametri di includere nella richiesta variano a seconda dell'operazione. Questo componente gestisce il controllo di [ridondanza ciclico (CRC) per verificare le](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) richieste di dati per te.  
Se la richiesta include una `address` proprietà, è necessario specificarne il valore come numero intero. Ad esempio, `"address": 1`.

`id`  <a name="connector-component-input-property-id"></a>
Un ID arbitrario della richiesta. Utilizzate questa proprietà per mappare una richiesta di input a una risposta di output. Quando specificate questa proprietà, il componente imposta la `id` proprietà nell'oggetto di risposta su questo valore.  
Tipo: `string`

**Example Esempio di input: richiesta lettura nastri**  

```
{
  "request": {
    "operation": "ReadCoilsRequest",
    "device": 1,
    "address": 1,
    "count": 1
  },
  "id": "MyRequest"
}
```

## Dati di output
<a name="modbus-rtu-protocol-adapter-component-output-data"></a>

 <a name="connector-component-output-data"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come contenuto `subject` nella configurazione del componente [legacy del router di abbonamento](legacy-subscription-router-component.md). Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consulta[AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md). 

**Argomento predefinito (AWS IoT Core MQTT):** `modbus/adapter/response`

La forma del messaggio di risposta dipende dall'operazione di richiesta e dallo stato della risposta. Per alcuni esempi, consulta [Richieste e risposte di esempio](#modbus-rtu-protocol-adapter-component-examples).

Ogni risposta include le seguenti proprietà:

`response`  
La risposta del dispositivo Modbus RTU.  
Tipo: `object` che contiene le seguenti informazioni:    
`status`  
Stato della richiesta. Lo stato può avere uno dei seguenti valori:  
+ `Success`— La richiesta era valida, il componente ha inviato la richiesta alla rete Modbus RTU e la rete Modbus RTU ha restituito una risposta.
+ `Exception`— La richiesta era valida, il componente ha inviato la richiesta alla rete Modbus RTU e la rete Modbus RTU ha restituito un'eccezione. Per ulteriori informazioni, consulta [Stato risposta: eccezione](#modbus-rtu-protocol-adapter-component-response-exception).
+ `No Response`— La richiesta non era valida e il componente ha rilevato l'errore prima di inviarla alla rete Modbus RTU. Per ulteriori informazioni, consulta [Stato risposta: nessuna risposta](#modbus-rtu-protocol-adapter-component-response-noresponse).  
`operation`  
Operazione richiesta dal componente.  
`device`  
Il dispositivo a cui il componente ha inviato la richiesta.  
`payload`  
La risposta del dispositivo Modbus RTU. Se `status` è`No Response`, questo oggetto contiene solo una `error` proprietà con la descrizione dell'errore (ad esempio,`[Input/Output] No Response received from the remote unit`).

`id`  
L'ID della richiesta, che è possibile utilizzare per identificare quale risposta corrisponde a quale richiesta.

**Nota**  
Una risposta a un'operazione di scrittura è semplicemente un eco della richiesta. Sebbene le risposte di scrittura non includano informazioni significative, è buona norma controllare lo stato della risposta per vedere se la richiesta ha esito positivo o negativo.

**Example Output di esempio: Operazione riuscita**  

```
{
  "response" : {
    "status" : "success",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "function_code": 1,
      "bits": [1]
    }
  },
  "id" : "MyRequest"
}
```

**Example Esempio di output: Errore**  

```
{
  "response" : {
    "status" : "fail",
    "error_message": "Internal Error",
    "error": "Exception",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "function_code": 129,
      "exception_code": 2
    }
  },
  "id" : "MyRequest"
}
```

Per ulteriori esempi, consulta [Richieste e risposte di esempio](#modbus-rtu-protocol-adapter-component-examples).

## Richieste e risposte RTU Modbus
<a name="modbus-rtu-protocol-adapter-component-requests-responses"></a>

Questo connettore accetta i parametri della richiesta RTU Modbus come [dati di input](#modbus-rtu-protocol-adapter-component-input-data) e pubblica le risposte come [dati di output](#modbus-rtu-protocol-adapter-component-output-data).

Sono supportate le seguenti operazioni comuni.


| Nome dell'operazione nella richiesta | Codice della funzione in risposta | 
| --- | --- | 
| ReadCoilsRequest | 01 | 
| ReadDiscreteInputsRequest | 02 | 
| ReadHoldingRegistersRequest | 03 | 
| ReadInputRegistersRequest | 04 | 
| WriteSingleCoilRequest | 05 | 
| WriteSingleRegisterRequest | 06 | 
| WriteMultipleCoilsRequest | 15 | 
| WriteMultipleRegistersRequest | 16 | 
| MaskWriteRegisterRequest | 22 | 
| ReadWriteMultipleRegistersRequest | 23 | 

### Richieste e risposte di esempio
<a name="modbus-rtu-protocol-adapter-component-examples"></a>

Di seguito sono riportate alcune richieste e risposte di esempio per le operazioni supportate.

Leggi le bobine  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "ReadCoilsRequest",
    "device": 1,
    "address": 1,
    "count": 1
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "function_code": 1,
      "bits": [1]
    }
  },
  "id" : "TestRequest"
}
```

Leggi gli ingressi discreti  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "ReadDiscreteInputsRequest",
    "device": 1,
    "address": 1,
    "count": 1
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "ReadDiscreteInputsRequest",
    "payload": {
      "function_code": 2,
      "bits": [1]
    }
  },
  "id" : "TestRequest"
}
```

Leggi i registri di detenzione  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "ReadHoldingRegistersRequest",
    "device": 1,
    "address": 1,
    "count": 1
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "ReadHoldingRegistersRequest",
    "payload": {
      "function_code": 3,
      "registers": [20,30]
    }
  },
  "id" : "TestRequest"
}
```

Leggi i registri di input  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "ReadInputRegistersRequest",
    "device": 1,
    "address": 1,
    "count": 1
  },
  "id": "TestRequest"
}
```

Scrivi bobina singola  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "WriteSingleCoilRequest",
    "device": 1,
    "address": 1,
    "value": 1
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "WriteSingleCoilRequest",
    "payload": {
      "function_code": 5,
      "address": 1,
      "value": true
    }
  },
  "id" : "TestRequest"
}
```

Scrivi un registro singolo  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "WriteSingleRegisterRequest",
    "device": 1,
    "address": 1,
    "value": 1
  },
  "id": "TestRequest"
}
```

Scrivi più bobine  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "WriteMultipleCoilsRequest",
    "device": 1,
    "address": 1,
    "values": [1,0,0,1]
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "WriteMultipleCoilsRequest",
    "payload": {
      "function_code": 15,
      "address": 1,
      "count": 4
    }
  },
  "id" : "TestRequest"
}
```

Scrivi più registri  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "WriteMultipleRegistersRequest",
    "device": 1,
    "address": 1,
    "values": [20,30,10]
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "WriteMultipleRegistersRequest",
    "payload": {
      "function_code": 23,
      "address": 1,
      "count": 3
    }
  },
  "id" : "TestRequest"
}
```

Maschera, scrittura, registro  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "MaskWriteRegisterRequest",
    "device": 1,
    "address": 1,
    "and_mask": 175,
    "or_mask": 1
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "MaskWriteRegisterRequest",
    "payload": {
      "function_code": 22,
      "and_mask": 0,
      "or_mask": 8
    }
  },
  "id" : "TestRequest"
}
```

Leggi e scrivi più registri  
**Esempio di richiesta:**  

```
{
  "request": {
    "operation": "ReadWriteMultipleRegistersRequest",
    "device": 1,
    "read_address": 1,
    "read_count": 2,
    "write_address": 3,
    "write_registers": [20,30,40]
  },
  "id": "TestRequest"
}
```
**Esempio di risposta:**  

```
{
  "response": {
    "status": "success",
    "device": 1,
    "operation": "ReadWriteMultipleRegistersRequest",
    "payload": {
      "function_code": 23,
      "registers": [10,20,10,20]
    }
  },
  "id" : "TestRequest"
}
```
La risposta include i registri letti dal componente.

### Stato risposta: eccezione
<a name="modbus-rtu-protocol-adapter-component-response-exception"></a>

Le eccezioni possono verificarsi se il formato della richiesta è valido, ma la richiesta non è stata completata. In questo caso, la risposta contiene le seguenti informazioni:
+ Il `status` è impostato su `Exception`.
+ `function_code` è pari al codice della funzione della richiesta \$1 128.
+ `exception_code` contiene il codice dell'eccezione. Per ulteriori informazioni sull'eccezione , consulta Codici delle eccezioni Modbus.

**Esempio**:

```
{
  "response": {
    "status": "fail",
    "error_message": "Internal Error",
    "error": "Exception",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "function_code": 129,
      "exception_code": 2
    }
  },
  "id": "TestRequest"
}
```

### Stato risposta: nessuna risposta
<a name="modbus-rtu-protocol-adapter-component-response-noresponse"></a>

Questo connettore esegue controlli di convalida sulla richiesta Modbus. Ad esempio, verifica l'eventuale presenza di formati non validi e campi non compilati. Se la convalida ha esito negativo, il connettore non invia la richiesta. Al contrario, restituirà una risposta contenente le seguenti informazioni:
+ Il `status` è impostato su `No Response`.
+ `error` contiene il motivo dell'errore.
+ `error_message` contiene il messaggio dell'errore.

**Esempi:**

```
{
  "response": {
    "status": "fail",
    "error_message": "Invalid address field. Expected <type 'int'>, got <type 'str'>",
    "error": "No Response",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "error": "Invalid address field. Expected Expected <type 'int'>, got <type 'str'>"
    }
  },
  "id": "TestRequest"
}
```

Se la richiesta è destinata a un dispositivo inesistente o se la rete RTU Modbus non funziona, potrebbe venire restituito `ModbusIOException`, che utilizza il formato Nessuna risposta.

```
{
  "response": {
    "status": "fail",
    "error_message": "[Input/Output] No Response received from the remote unit",
    "error": "No Response",
    "device": 1,
    "operation": "ReadCoilsRequest",
    "payload": {
      "error": "[Input/Output] No Response received from the remote unit"
    }
  },
  "id": "TestRequest"
}
```

## File di registro locale
<a name="modbus-rtu-protocol-adapter-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.Modbus.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.Modbus.log
  ```

## Licenze
<a name="modbus-rtu-protocol-adapter-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:
+ [Licenza pymodbus/BSD](https://github.com/riptideio/pymodbus/blob/master/README.rst)
+ [Licenza pyserial](https://github.com/pyserial/pyserial) /BSD

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="modbus-rtu-protocol-adapter-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.11  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.1.10  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.6  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.5  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html) | 
|  2.1.4  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html)  | 
|  2.0.8  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

# Ponte MQTT
<a name="mqtt-bridge-component"></a>

Il componente bridge MQTT (`aws.greengrass.clientdevices.mqtt.Bridge`) inoltra i messaggi MQTT tra i dispositivi client, il servizio di pubblicazione/sottoscrizione locale di Greengrass e. AWS IoT CoreÈ possibile utilizzare questo componente per agire sui messaggi MQTT provenienti dai dispositivi client in componenti personalizzati e sincronizzare i dispositivi client con. Cloud AWS

**Nota**  <a name="client-device-component-context"></a>
I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta [Interagisci con dispositivi IoT locali](interact-with-local-iot-devices.md).

È possibile utilizzare questo componente per inoltrare messaggi tra i seguenti broker di messaggi:
+ MQTT locale: il broker MQTT locale gestisce i messaggi tra i dispositivi client e un dispositivo principale.
+ Locale publish/subscribe : il broker di messaggi Greengrass locale gestisce i messaggi tra i componenti di un dispositivo principale. Per ulteriori informazioni su come interagire con questi messaggi nei componenti Greengrass, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ AWS IoT Core — Il broker AWS IoT Core MQTT gestisce i messaggi tra dispositivi IoT e Cloud AWS destinazioni. Per ulteriori informazioni su come interagire con questi messaggi nei componenti Greengrass, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)

**Topics**
+ [Versioni](#mqtt-bridge-component-versions)
+ [Tipo](#mqtt-bridge-component-type)
+ [Sistema operativo](#mqtt-bridge-component-os-support)
+ [Requisiti](#mqtt-bridge-component-requirements)
+ [Dipendenze](#mqtt-bridge-component-dependencies)
+ [Configurazione](#mqtt-bridge-component-configuration)
+ [File di registro locale](#mqtt-bridge-component-log-file)
+ [Changelog](#mqtt-bridge-component-changelog)

## Versioni
<a name="mqtt-bridge-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="mqtt-bridge-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="mqtt-bridge-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="mqtt-bridge-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Se si configura il componente broker MQTT del dispositivo principale per utilizzare una porta diversa dalla porta predefinita 8883, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per connetterti alla porta in cui opera il broker.
+ Il componente bridge MQTT è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="mqtt-bridge-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#mqtt-bridge-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.3.2 ]

La tabella seguente elenca le dipendenze per la versione 2.3.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Rigidi | 

------
#### [ 2.3.0 and 2.3.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rigidi | 

------
#### [ 2.2.5 and 2.2.6 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.5 e 2.2.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rigidi | 

------
#### [ 2.2.3 and 2.2.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.3 e 2.2.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Rigidi | 

------
#### [ 2.2.0 – 2.2.2 ]

La tabella seguente elenca le dipendenze per le versioni da 2.2.0 a 2.2.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Rigidi | 

------
#### [ 2.0.0 to 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.0 a 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="mqtt-bridge-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.3.0 – 2.3.2 ]

`mqttTopicMapping`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-description"></a>Le mappature degli argomenti che desideri collegare. Questo componente sottoscrive i messaggi sull'argomento di origine e pubblica i messaggi che riceve nell'argomento di destinazione. Ogni mappatura degli argomenti definisce l'argomento, il tipo di origine e il tipo di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
`topicMappingNameKey`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-name-key-description"></a>Il nome di questa mappatura degli argomenti. *topicMappingNameKey*Sostituiscilo con un nome che ti aiuti a identificare questa mappatura degli argomenti.  
Questo oggetto contiene le seguenti informazioni:    
`topic`  
L'argomento o il filtro degli argomenti da collegare tra il broker di origine e quello di destinazione.  
È possibile utilizzare i caratteri jolly degli argomenti `+` e `#` MQTT per inoltrare messaggi su tutti gli argomenti che corrispondono a un filtro per argomento. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *  
[Per utilizzare i caratteri jolly degli argomenti MQTT con il broker dei `Pubsub` sorgenti, è necessario utilizzare la versione 2.6.0 o successiva del componente Greengrass nucleus.](greengrass-nucleus-component.md)  
`targetTopicPrefix`  
Il prefisso da aggiungere all'argomento di destinazione quando questo componente inoltra il messaggio.  
`source`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-source"></a>
Il broker di messaggi di origine. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.  
`target`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-target"></a>
Il broker di messaggi di destinazione. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.

mqtt5 RouteOptions  
(Facoltativo) Fornisce opzioni per configurare le mappature degli argomenti per collegare i messaggi dall'argomento di origine a quello di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
*mqtt5RouteOptionsNameKey*  
Il nome delle opzioni di percorso per la mappatura di un argomento. Sostituisci *mqtt5RouteOptionsNameKey* con la corrispondenza *topicMappingNameKey* definita nel `mqttTopicMapping` campo.  
Questo oggetto contiene le seguenti informazioni:    
NoLocal  
(Facoltativo) Se abilitato, il bridge non inoltra messaggi su un argomento pubblicato dal bridge stesso. Utilizzatelo per prevenire i loop, come segue:  

```
{
    "mqtt5RouteOptions": {
        "toIoTCore": {
            "noLocal": true
        }
    },
    "mqttTopicMapping": {
        "toIoTCore": {
            "topic": "device",
            "source": "LocalMqtt",
            "target": "IotCore"
        },
        "toLocal": {
            "topic": "device",
            "source": "IotCore",
            "target": "LocalMqtt"
        }
    }
}
```
`noLocal`è supportato solo per i percorsi in cui `source` è`LocalMqtt`.  
Impostazione predefinita: false  
retainAsPublished  
(Facoltativo) Se abilitato, i messaggi inoltrati dal bridge hanno lo stesso `retain` contrassegno dei messaggi pubblicati sul broker per quella rotta.  
`retainAsPublished`è supportato solo per i percorsi in cui è`source`. `LocalMqtt`  
Impostazione predefinita: false

mqtt  
(Facoltativo) Impostazioni del protocollo MQTT per la comunicazione con il broker locale.    
version  
(Facoltativo) La versione del protocollo MQTT utilizzata dal bridge per comunicare con il broker locale. Deve essere la stessa della versione MQTT selezionata nella configurazione del nucleo.   
Scegli tra le seguenti opzioni:   
+ `mqtt3`
+ `mqtt5`
È necessario implementare un broker MQTT quando il `target` campo `source` o dell'`mqttTopicMapping`oggetto è impostato su. `LocalMqtt` Se si sceglie l'`mqtt5`opzione, è necessario utilizzare il. [Broker MQTT 5 (EMQX)](mqtt-broker-emqx-component.md)  
Impostazione predefinita: `mqtt3`  
ackTimeoutSeconds  
(Facoltativo) Intervallo di tempo in cui attendere i pacchetti PUBACK, SUBACK o UNSUBACK prima di fallire l'operazione.  
Impostazione predefinita: 60  
connAckTimeoutSig.ra  
(Facoltativo) Intervallo di tempo di attesa di un pacchetto CONNACK prima di interrompere la connessione.  
Impostazione predefinita: 20000 (20 secondi)  
pingTimeoutMs  
(Facoltativo) La quantità di tempo in millisecondi che il bridge attende per ricevere un messaggio PINGACK dal broker locale. Se l'attesa supera il timeout, il bridge si chiude e riapre la connessione MQTT. Questo valore deve essere inferiore a. `keepAliveTimeoutSeconds`  
Impostazione predefinita: 30000 (30 secondi)  
keepAliveTimeoutSecondi  
(Facoltativo) La quantità di tempo in secondi tra ogni messaggio PING inviato dal bridge per mantenere attiva la connessione MQTT. Questo valore deve essere maggiore di. `pingTimeoutMs`  
Impostazione predefinita: 60  
maxReconnectDelaySig.ra  
(Facoltativo) Il tempo massimo in secondi per la riconnessione di MQTT.  
Impostazione predefinita: 30000 (30 secondi)  
minReconnectDelaySig.ra  
(Facoltativo) Il tempo minimo in secondi per la riconnessione di MQTT.  
Ricevi il massimo  
(Facoltativo) Il numero massimo di pacchetti QoS1 non riconosciuti che il bridge può inviare.  
Impostazione predefinita: 100  
maximumPacketSize  
Il numero massimo di byte che il client accetterà per un pacchetto MQTT.  
Impostazione predefinita: null (nessun limite)  
sessionExpiryInterval  
(Facoltativo) La quantità di tempo in secondi che è possibile richiedere per la durata di una sessione tra il bridge e il broker locale.  
Impostazione predefinita: 4294967295 (la sessione non scade mai)

`brokerUri`  <a name="mqtt-bridge-component-configuration-broker-uri"></a>
(Facoltativo) L'URI del broker MQTT locale. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883. Utilizzate il seguente formato e sostituitelo *port* con la porta in cui opera il broker MQTT:. `ssl://localhost:port`  
Impostazione predefinita: `ssl://localhost:8883`

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo in secondi per l'avvio del componente. Lo stato del componente cambia `BROKEN` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: fusione e aggiornamento della configurazione**  <a name="mqtt-bridge-component-configuration-example-with-prefix"></a>
Il seguente esempio di aggiornamento della configurazione specifica quanto segue:  
+ Inoltra i messaggi dai dispositivi client agli AWS IoT Core argomenti che corrispondono al filtro degli `clients/+/hello/world` argomenti.
+ Inoltra i messaggi dai dispositivi client a quelli locali publish/subscribe sugli argomenti che corrispondono al filtro degli argomenti e aggiungi il `events/input/` prefisso all'`clients/+/detections`argomento di destinazione. L'argomento di destinazione risultante corrisponde al filtro degli `events/input/clients/+/detections` argomenti.
+ Inoltra i messaggi dai dispositivi client AWS IoT Core agli argomenti che corrispondono al filtro degli argomenti e aggiungi il `$aws/rules/StatusUpdateRule/` prefisso all'`clients/+/status`argomento di destinazione. [Questo esempio inoltra questi messaggi direttamente a una [AWS IoT regola](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) denominata per `StatusUpdateRule` ridurre i costi utilizzando Basic Ingest.](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html)

```
{
  "mqttTopicMapping": {
    "ClientDeviceHelloWorld": {
      "topic": "clients/+/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    },
    "ClientDeviceEvents": {
      "topic": "clients/+/detections",
      "targetTopicPrefix": "events/input/",
      "source": "LocalMqtt",
      "target": "Pubsub"
    },
    "ClientDeviceCloudStatusUpdate": {
      "topic": "clients/+/status",
      "targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  }
}
```

**Example Esempio: configurazione di MQTT 5**  
La seguente configurazione di esempio aggiorna quanto segue:  
+ Consente al bridge di utilizzare il protocollo MQTT 5 con il broker locale.
+ Configura MQTT keep come impostazione pubblicata per la mappatura degli `ClientDeviceHelloWorld` argomenti.

```
{
  "mqttTopicMapping": {
    "ClientDeviceHelloWorld": {
      "topic": "clients/+/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  },
  "mqtt5RouteOptions": {
    "ClientDeviceHelloWorld": {
      "retainAsPublished": true
    }
  },
  "mqtt": {
    "version": "mqtt5"
  }
}
```

------
#### [ 2.2.6 ]

`mqttTopicMapping`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-description"></a>Le mappature degli argomenti che desideri collegare. Questo componente sottoscrive i messaggi sull'argomento di origine e pubblica i messaggi che riceve nell'argomento di destinazione. Ogni mappatura degli argomenti definisce l'argomento, il tipo di origine e il tipo di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
`topicMappingNameKey`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-name-key-description"></a>Il nome di questa mappatura degli argomenti. *topicMappingNameKey*Sostituiscilo con un nome che ti aiuti a identificare questa mappatura degli argomenti.  
Questo oggetto contiene le seguenti informazioni:    
`topic`  
L'argomento o il filtro degli argomenti da collegare tra il broker di origine e quello di destinazione.  
È possibile utilizzare i caratteri jolly degli argomenti `+` e `#` MQTT per inoltrare messaggi su tutti gli argomenti che corrispondono a un filtro per argomento. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *  
[Per utilizzare i caratteri jolly degli argomenti MQTT con il broker dei `Pubsub` sorgenti, è necessario utilizzare la versione 2.6.0 o successiva del componente Greengrass nucleus.](greengrass-nucleus-component.md)  
`targetTopicPrefix`  
Il prefisso da aggiungere all'argomento di destinazione quando questo componente inoltra il messaggio.  
`source`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-source"></a>
Il broker di messaggi di origine. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.  
`target`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-target"></a>
Il broker di messaggi di destinazione. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.

`brokerUri`  <a name="mqtt-bridge-component-configuration-broker-uri"></a>
(Facoltativo) L'URI del broker MQTT locale. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883. Utilizzate il seguente formato e sostituitelo *port* con la porta in cui opera il broker MQTT:. `ssl://localhost:port`  
Impostazione predefinita: `ssl://localhost:8883`

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo in secondi per l'avvio del componente. Lo stato del componente cambia `BROKEN` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: fusione e aggiornamento della configurazione**  <a name="mqtt-bridge-component-configuration-example-with-prefix"></a>
Il seguente esempio di aggiornamento della configurazione specifica quanto segue:  
+ Inoltra i messaggi dai dispositivi client agli AWS IoT Core argomenti che corrispondono al filtro degli `clients/+/hello/world` argomenti.
+ Inoltra i messaggi dai dispositivi client a quelli locali publish/subscribe sugli argomenti che corrispondono al filtro degli argomenti e aggiungi il `events/input/` prefisso all'`clients/+/detections`argomento di destinazione. L'argomento di destinazione risultante corrisponde al filtro degli `events/input/clients/+/detections` argomenti.
+ Inoltra i messaggi dai dispositivi client AWS IoT Core agli argomenti che corrispondono al filtro degli argomenti e aggiungi il `$aws/rules/StatusUpdateRule/` prefisso all'`clients/+/status`argomento di destinazione. [Questo esempio inoltra questi messaggi direttamente a una [AWS IoT regola](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) denominata per `StatusUpdateRule` ridurre i costi utilizzando Basic Ingest.](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html)

```
{
  "mqttTopicMapping": {
    "ClientDeviceHelloWorld": {
      "topic": "clients/+/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    },
    "ClientDeviceEvents": {
      "topic": "clients/+/detections",
      "targetTopicPrefix": "events/input/",
      "source": "LocalMqtt",
      "target": "Pubsub"
    },
    "ClientDeviceCloudStatusUpdate": {
      "topic": "clients/+/status",
      "targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  }
}
```

------
#### [ 2.2.0 - 2.2.5 ]

`mqttTopicMapping`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-description"></a>Le mappature degli argomenti che vuoi collegare. Questo componente sottoscrive i messaggi sull'argomento di origine e pubblica i messaggi che riceve nell'argomento di destinazione. Ogni mappatura degli argomenti definisce l'argomento, il tipo di origine e il tipo di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
`topicMappingNameKey`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-name-key-description"></a>Il nome di questa mappatura degli argomenti. *topicMappingNameKey*Sostituiscilo con un nome che ti aiuti a identificare questa mappatura degli argomenti.  
Questo oggetto contiene le seguenti informazioni:    
`topic`  
L'argomento o il filtro degli argomenti da collegare tra il broker di origine e quello di destinazione.  
È possibile utilizzare i caratteri jolly degli argomenti `+` e `#` MQTT per inoltrare messaggi su tutti gli argomenti che corrispondono a un filtro per argomento. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *  
[Per utilizzare i caratteri jolly degli argomenti MQTT con il broker dei `Pubsub` sorgenti, è necessario utilizzare la versione 2.6.0 o successiva del componente Greengrass nucleus.](greengrass-nucleus-component.md)  
`targetTopicPrefix`  
Il prefisso da aggiungere all'argomento di destinazione quando questo componente inoltra il messaggio.  
`source`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-source"></a>
Il broker di messaggi di origine. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.  
`target`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-target"></a>
Il broker di messaggi di destinazione. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.

`brokerUri`  <a name="mqtt-bridge-component-configuration-broker-uri"></a>
(Facoltativo) L'URI del broker MQTT locale. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883. Utilizzate il seguente formato e sostituitelo *port* con la porta in cui opera il broker MQTT:. `ssl://localhost:port`  
Impostazione predefinita: `ssl://localhost:8883`

**Example Esempio: fusione e aggiornamento della configurazione**  <a name="mqtt-bridge-component-configuration-example-with-prefix"></a>
Il seguente esempio di aggiornamento della configurazione specifica quanto segue:  
+ Inoltra i messaggi dai dispositivi client agli AWS IoT Core argomenti che corrispondono al filtro degli `clients/+/hello/world` argomenti.
+ Inoltra i messaggi dai dispositivi client a quelli locali publish/subscribe sugli argomenti che corrispondono al filtro degli argomenti e aggiungi il `events/input/` prefisso all'`clients/+/detections`argomento di destinazione. L'argomento di destinazione risultante corrisponde al filtro degli `events/input/clients/+/detections` argomenti.
+ Inoltra i messaggi dai dispositivi client AWS IoT Core agli argomenti che corrispondono al filtro degli argomenti e aggiungi il `$aws/rules/StatusUpdateRule/` prefisso all'`clients/+/status`argomento di destinazione. [Questo esempio inoltra questi messaggi direttamente a una [AWS IoT regola](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) denominata per `StatusUpdateRule` ridurre i costi utilizzando Basic Ingest.](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html)

```
{
  "mqttTopicMapping": {
    "ClientDeviceHelloWorld": {
      "topic": "clients/+/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    },
    "ClientDeviceEvents": {
      "topic": "clients/+/detections",
      "targetTopicPrefix": "events/input/",
      "source": "LocalMqtt",
      "target": "Pubsub"
    },
    "ClientDeviceCloudStatusUpdate": {
      "topic": "clients/+/status",
      "targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  }
}
```

------
#### [ 2.1.x ]

`mqttTopicMapping`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping"></a>
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-description"></a>Le mappature degli argomenti che vuoi collegare. Questo componente sottoscrive i messaggi sull'argomento di origine e pubblica i messaggi che riceve nell'argomento di destinazione. Ogni mappatura degli argomenti definisce l'argomento, il tipo di origine e il tipo di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
`topicMappingNameKey`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-name-key-description"></a>Il nome di questa mappatura degli argomenti. *topicMappingNameKey*Sostituiscilo con un nome che ti aiuti a identificare questa mappatura degli argomenti.  
Questo oggetto contiene le seguenti informazioni:    
`topic`  
L'argomento o il filtro degli argomenti da collegare tra il broker di origine e quello di destinazione.  
Se si specifica il broker `LocalMqtt` o il broker di `IotCore` origine, è possibile utilizzare i caratteri jolly degli argomenti `+` e `#` MQTT per inoltrare messaggi su tutti gli argomenti che corrispondono a un filtro di argomento. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *  
`source`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-source"></a>
Il broker di messaggi di origine. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.  
`target`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-target"></a>
Il broker di messaggi di destinazione. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.

`brokerUri`  <a name="mqtt-bridge-component-configuration-broker-uri"></a>
(Facoltativo) L'URI del broker MQTT locale. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883. Utilizzate il seguente formato e sostituitelo *port* con la porta in cui opera il broker MQTT:. `ssl://localhost:port`  
Impostazione predefinita: `ssl://localhost:8883`

**Example Esempio: fusione e aggiornamento della configurazione**  <a name="mqtt-bridge-component-configuration-example-no-prefix"></a>
L'esempio seguente di aggiornamento della configurazione specifica di inoltrare i messaggi dai dispositivi client agli argomenti AWS IoT Core on and. `clients/MyClientDevice1/hello/world` `clients/MyClientDevice2/hello/world`  

```
{
  "mqttTopicMapping": {
    "ClientDevice1HelloWorld": {
      "topic": "clients/MyClientDevice1/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    },
    "ClientDevice2HelloWorld": {
      "topic": "clients/MyClientDevice2/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  }
}
```

------
#### [ 2.0.x ]

`mqttTopicMapping`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping"></a>
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-description"></a>Le mappature degli argomenti che vuoi collegare. Questo componente sottoscrive i messaggi sull'argomento di origine e pubblica i messaggi che riceve nell'argomento di destinazione. Ogni mappatura degli argomenti definisce l'argomento, il tipo di origine e il tipo di destinazione.  
Questo oggetto contiene le seguenti informazioni:    
`topicMappingNameKey`  
<a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-name-key-description"></a>Il nome di questa mappatura degli argomenti. *topicMappingNameKey*Sostituiscilo con un nome che ti aiuti a identificare questa mappatura degli argomenti.  
Questo oggetto contiene le seguenti informazioni:    
`topic`  
L'argomento o il filtro degli argomenti da collegare tra il broker di origine e quello di destinazione.  
Se si specifica il broker `LocalMqtt` o il broker di `IotCore` origine, è possibile utilizzare i caratteri jolly degli argomenti `+` e `#` MQTT per inoltrare messaggi su tutti gli argomenti che corrispondono a un filtro di argomento. *Per ulteriori informazioni, consultate gli [argomenti relativi a MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *  
`source`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-source"></a>
Il broker di messaggi di origine. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.  
`target`  <a name="mqtt-bridge-component-configuration-mqtt-topic-mapping-target"></a>
Il broker di messaggi di destinazione. Seleziona una delle opzioni seguenti:  <a name="mqtt-bridge-component-configuration-topic-types"></a>
+ `LocalMqtt`— Il broker MQTT locale con cui comunicano i dispositivi client.
+ `Pubsub`— Il broker di publish/subscribe messaggi locale Greengrass.
+ `IotCore`— Il broker di messaggi AWS IoT Core MQTT.
**Nota**  <a name="mqtt-bridge-component-iotcore-qos-1-note"></a>
Il bridge MQTT utilizza QoS 1 per pubblicare e AWS IoT Core sottoscrivere, anche quando un dispositivo client utilizza QoS 0 per pubblicare e sottoscrivere il broker MQTT locale. Di conseguenza, è possibile osservare una latenza aggiuntiva quando si inoltrano messaggi MQTT dai dispositivi client sul broker MQTT locale a. AWS IoT Core Per ulteriori informazioni sulla configurazione MQTT sui dispositivi principali, vedere. [Configurare i timeout MQTT e le impostazioni della cache](configure-greengrass-core-v2.md#configure-mqtt)
`source`e `target` deve essere diverso.

**Example Esempio: fusione e aggiornamento della configurazione**  <a name="mqtt-bridge-component-configuration-example-no-prefix"></a>
L'esempio seguente di aggiornamento della configurazione specifica di inoltrare i messaggi dai dispositivi client agli argomenti AWS IoT Core on and. `clients/MyClientDevice1/hello/world` `clients/MyClientDevice2/hello/world`  

```
{
  "mqttTopicMapping": {
    "ClientDevice1HelloWorld": {
      "topic": "clients/MyClientDevice1/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    },
    "ClientDevice2HelloWorld": {
      "topic": "clients/MyClientDevice2/hello/world",
      "source": "LocalMqtt",
      "target": "IotCore"
    }
  }
}
```

------

## File di registro locale
<a name="mqtt-bridge-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="mqtt-bridge-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.3.2  |  Versione aggiornata per la versione 2.5.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
| 2.3.1 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
| 2.3.0 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.2.6  |  <a name="changelog-mqtt-bridge-2.2.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.2.5  |  Versione aggiornata per la versione 2.4.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
|  2.2.4  |  Versione aggiornata per la versione 2.3.0 di [autenticazione del dispositivo client](client-device-auth-component.md) Greengrass.  | 
|  2.2.3  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.2.0  |  <a name="changelog-mqtt-bridge-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-bridge-component.html)  | 
|  2.0.1  |  Questa versione include correzioni di bug e miglioramenti.  | 
|  2.0.0  |  Versione iniziale.  | 

# Broker MQTT 3.1.1 (Moquette)
<a name="mqtt-broker-moquette-component"></a>

Il componente broker Moquette MQTT (`aws.greengrass.clientdevices.mqtt.Moquette`) gestisce i messaggi MQTT tra i dispositivi client e un dispositivo core Greengrass. [Questo componente fornisce una versione modificata del broker Moquette MQTT.](https://github.com/moquette-io/moquette) Implementa questo broker MQTT per gestire un broker MQTT leggero. Per ulteriori informazioni su come scegliere un broker MQTT, consulta. [Scegli un broker MQTT](choose-local-mqtt-broker.md)

Questo broker implementa il protocollo MQTT 3.1.1. Include il supporto per i messaggi conservati di QoS 0, QoS 1, QoS 2, i messaggi di ultima volontà e le sessioni persistenti.

**Nota**  <a name="client-device-component-context"></a>
I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta [Interagisci con dispositivi IoT locali](interact-with-local-iot-devices.md).

**Topics**
+ [Versioni](#mqtt-broker-moquette-component-versions)
+ [Tipo](#mqtt-broker-moquette-component-type)
+ [Sistema operativo](#mqtt-broker-moquette-component-os-support)
+ [Requisiti](#mqtt-broker-moquette-component-requirements)
+ [Dipendenze](#mqtt-broker-moquette-component-dependencies)
+ [Configurazione](#mqtt-broker-moquette-component-configuration)
+ [File di registro locale](#mqtt-broker-moquette-component-log-file)
+ [Changelog](#mqtt-broker-moquette-component-changelog)

## Versioni
<a name="mqtt-broker-moquette-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="mqtt-broker-moquette-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="mqtt-broker-moquette-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="mqtt-broker-moquette-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale deve essere in grado di accettare connessioni sulla porta in cui opera il broker MQTT. Per impostazione predefinita, questo componente esegue il broker MQTT sulla porta 8883. È possibile specificare una porta diversa quando si configura questo componente.

  <a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente bridge MQTT](mqtt-bridge-component.md) per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.

  <a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente IP detector](ip-detector-component.md) per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.
+ Il componente broker Moquette MQTT è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="mqtt-broker-moquette-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#mqtt-broker-moquette-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.3.7 ]

La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Rigidi | 

------
#### [ 2.3.2 – 2.3.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.3.2 a 2.3.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rigidi | 

------
#### [ 2.3.0 and 2.3.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Rigidi | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Rigidi | 

------
#### [ 2.0.0 - 2.0.2 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.0 a 2.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="mqtt-broker-moquette-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`moquette`  
(Facoltativo) La configurazione del [broker Moquette MQTT](https://github.com/moquette-io/moquette) da utilizzare. È possibile configurare un sottoinsieme di opzioni di configurazione Moquette in questo componente. [Per ulteriori informazioni, consultate i commenti in linea nel file di configurazione di Moquette.](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf)  
Questo oggetto contiene le seguenti informazioni:    
`ssl_port`  
(Facoltativo) La porta in cui opera il broker MQTT.  
<a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente bridge MQTT](mqtt-bridge-component.md) per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.  
<a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente IP detector](ip-detector-component.md) per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.
Impostazione predefinita: `8883`  
`host`  
(Facoltativo) L'interfaccia a cui si collega il broker MQTT. Ad esempio, è possibile modificare questo parametro in modo che il broker MQTT si colleghi solo a una rete locale specifica.  
Impostazione predefinita: `0.0.0.0` (si collega a tutte le interfacce di rete)

startupTimeoutSeconds  
(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia `BROKEN` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di utilizzare il broker MQTT sulla porta 443.  

```
{
  "moquette": {
    "ssl_port": "443"
  }
}
```

## File di registro locale
<a name="mqtt-broker-moquette-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="mqtt-broker-moquette-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.3.7  |  Versione aggiornata per la versione 2.5.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
|  2.3.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.3  |  <a name="changelog-mqtt-broker-moquette-2.3.3"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.2  |  Versione aggiornata per la versione 2.4.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.3.0  |  Aggiunge il supporto per le catene di certificati.  | 
|  2.2.0  |  Versione aggiornata per la versione 2.2.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-moquette-component.html)  | 
|  2.0.1  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.0  |  Versione iniziale.  | 

# Broker MQTT 5 (EMQX)
<a name="mqtt-broker-emqx-component"></a>

Il componente broker EMQX MQTT (`aws.greengrass.clientdevices.mqtt.EMQX`) gestisce i messaggi MQTT tra i dispositivi client e un dispositivo core Greengrass. [Questo componente fornisce una versione modificata del broker EMQX MQTT 5.0.](https://www.emqx.com/en/mqtt/mqtt5) Implementate questo broker MQTT per utilizzare le funzionalità MQTT 5 nella comunicazione tra i dispositivi client e un dispositivo principale. Per ulteriori informazioni su come scegliere un broker MQTT, vedere. [Scegli un broker MQTT](choose-local-mqtt-broker.md)

Questo broker implementa il protocollo MQTT 5.0. Include il supporto per gli intervalli di scadenza delle sessioni e dei messaggi, le proprietà degli utenti, le sottoscrizioni condivise, gli alias degli argomenti e altro ancora. MQTT 5 è retrocompatibile con MQTT 3.1.1, quindi se si utilizza il broker [Moquette MQTT 3.1.1, è possibile sostituirlo con il broker](mqtt-broker-moquette-component.md) EMQX MQTT 5 e i dispositivi client possono continuare a connettersi e funzionare come al solito.

<a name="note-local-mqtt-broker-mqtt-5-features"></a>

**Nota**  <a name="client-device-component-context"></a>
I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta [Interagisci con dispositivi IoT locali](interact-with-local-iot-devices.md).

**Topics**
+ [Versioni](#mqtt-broker-emqx-component-versions)
+ [Tipo](#mqtt-broker-emqx-component-type)
+ [Sistema operativo](#mqtt-broker-emqx-component-os-support)
+ [Requisiti](#mqtt-broker-emqx-component-requirements)
+ [Dipendenze](#mqtt-broker-emqx-component-dependencies)
+ [Configurazione](#mqtt-broker-emqx-component-configuration)
+ [File di registro locale](#mqtt-broker-emqx-component-log-file)
+ [Licenze](#mqtt-broker-emqx-component-licenses)
+ [Changelog](#mqtt-broker-emqx-component-changelog)

## Versioni
<a name="mqtt-broker-emqx-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Tipo
<a name="mqtt-broker-emqx-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="mqtt-broker-emqx-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="mqtt-broker-emqx-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale deve essere in grado di accettare connessioni sulla porta in cui opera il broker MQTT. Per impostazione predefinita, questo componente esegue il broker MQTT sulla porta 8883. È possibile specificare una porta diversa quando si configura questo componente.

  <a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente bridge MQTT](mqtt-bridge-component.md) per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.

  <a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente IP detector](ip-detector-component.md) per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.
+ Sui dispositivi principali Linux, Docker è installato e configurato sul dispositivo principale:
  + <a name="docker-engine-requirement"></a>[Docker Engine](https://docs.docker.com/engine/) 1.9.1 o versione successiva installato sul dispositivo principale Greengrass. La versione 20.10 è l'ultima versione verificata per funzionare con il software Core. AWS IoT Greengrass È necessario installare Docker direttamente sul dispositivo principale prima di distribuire componenti che eseguono contenitori Docker.
  + <a name="docker-daemon-requirement"></a>Il daemon Docker è stato avviato e funzionante sul dispositivo principale prima di distribuire questo componente. 
  + L'utente di sistema che esegue questo componente deve disporre delle autorizzazioni di root o di amministratore. In alternativa, è possibile eseguire questo componente come utente di sistema nel `docker` gruppo e configurare l'`requiresPrivileges`opzione di questo componente per `false` eseguire il broker MQTT EQMX senza privilegi.
+ Il componente broker EMQX MQTT è supportato per l'esecuzione in un VPC.
+ Il componente broker EMQX MQTT non è supportato sulla piattaforma. `armv7`

## Dipendenze
<a name="mqtt-broker-emqx-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#mqtt-broker-emqx-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.0.2 – 2.0.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.2 e 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Flessibili | 

------
#### [ 2.0.1 ]

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Rigidi | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rigidi | 

------
#### [ 1.2.2 – 1.2.3 ]

La tabella seguente elenca le dipendenze per le versioni da 1.2.2 a 1.2.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Rigidi | 

------
#### [ 1.2.0 and 1.2.1 ]

La tabella seguente elenca le dipendenze per le versioni 1.2.0 e 1.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Rigidi | 

------
#### [ 1.0.0 and 1.1.0 ]

La tabella seguente elenca le dipendenze per le versioni 1.0.0 e 1.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Autenticazione del dispositivo client](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="mqtt-broker-emqx-component-configuration"></a>

------
#### [ 2.0.0 - 2.0.3 ]

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Importante**  
Se si utilizza la versione 2 del componente del broker MQTT 5 (EMQX), è necessario aggiornare il file di configurazione. I file di configurazione della versione 1 non funzionano con la versione 2.

emqxConfig  
 (Facoltativo) La configurazione del broker [EMQX MQTT](https://www.emqx.io/docs/en/v5.1/configuration/configuration.html) da utilizzare. È possibile impostare le opzioni di configurazione EMQX in questo componente.  
Quando si utilizza il broker EMQX, Greengrass utilizza una configurazione predefinita. Questa configurazione viene utilizzata a meno che non venga modificata utilizzando questo campo.  
La modifica delle seguenti impostazioni di configurazione causa il riavvio del componente del broker EMQX. Le altre modifiche alla configurazione si applicano senza riavviare il componente.  
+ `emqxConfig/cluster`
+ `emqxConfig/node`
+ `emqxConfig/rpc`
`aws.greengrass.clientdevices.mqtt.EMQX`consente di configurare opzioni sensibili alla sicurezza. Questi includono impostazioni TLS, autenticazione e provider di autorizzazione. Abbiamo consigliato la configurazione predefinita che utilizza l'autenticazione TLS reciproca e il provider di autenticazione del dispositivo client Greengrass.

**Example Esempio: configurazione predefinita**  
L'esempio seguente mostra i valori predefiniti impostati per il broker MQTT 5 (EMQX). È possibile sovrascrivere queste impostazioni utilizzando l'impostazione di configurazione. `emqxConfig`  

```
{
  "authorization": {
    "no_match": "deny",
    "sources": []
  },
  "node": {
    "cookie": "<placeholder>"
  }, 
  "listeners": {
     "ssl": {
       "default": {
         "ssl_options": {
           "keyfile": "{work:path}\\data\\key.pem",
           "certfile": "{work:path}\\data\\cert.pem",
           "cacertfile": null,
           "verify": "verify_peer",
           "versions": ["tlsv1.3", "tlsv1.2"],
           "fail_if_no_peer_cert": true
         }
       }
     },
     "tcp": {
       "default": {
         "enabled": false
       }
     },
     "ws": {
       "default": {
         "enabled": false
       }
     },
     "wss": {
       "default": {
         "enabled": false
       }
     }
  },
  "plugins": {
    "states": [{"name_vsn": "gg-1.0.0", "enable": true}],
    "install_dir": "plugins"
  }
}
```

AuthMode  
(Facoltativo) Imposta il provider di autorizzazione per il broker. Può essere uno dei seguenti valori:  
+ `enabled`— (Impostazione predefinita) Utilizza il provider di autenticazione e autorizzazione Greengrass.
+ `bypass_on_failure`— Utilizzare il provider di autenticazione Greengrass, quindi utilizzare tutti i provider di autenticazione rimanenti nella catena di provider EMQX se Greengrass nega l'autenticazione o l'autorizzazione.
+ `bypass`— Il provider Greengrass è disabilitato. L'autenticazione e l'autorizzazione sono gestite dalla catena di fornitori EMQX.

`requiresPrivilege`  
(Facoltativo) Sui dispositivi principali Linux, è possibile specificare di eseguire il broker EMQX MQTT senza privilegi di root o amministratore. Se si imposta questa opzione su`false`, l'utente di sistema che esegue questo componente deve essere un membro del gruppo. `docker`  
Impostazione predefinita: `true`

`startupTimeoutSeconds`  
(Facoltativo) Il tempo massimo in secondi per l'avvio del broker EMQX MQTT. Lo stato del componente cambia `BROKEN` se supera questo timeout.  
Impostazione predefinita: `90`

`ipcTimeoutSeconds`  
(Facoltativo) Il tempo massimo, in secondi, impiegato dal componente per attendere che il nucleo Greengrass risponda alle richieste di comunicazione tra processi (IPC). Aumentate questo numero se questo componente segnala errori di timeout quando verifica se un dispositivo client è autorizzato.  
Impostazione predefinita: `5`

`crtLogLevel`  
(Facoltativo) Il livello di registro per la libreria AWS Common Runtime (CRT).  
Il valore predefinito è il livello di log del broker EMQX MQTT (in). `log.level` `emqx`

`restartIdentifier`  
(Facoltativo) Configurare questa opzione per riavviare il broker EMQX MQTT. Quando questo valore di configurazione cambia, questo componente riavvia il broker MQTT. È possibile utilizzare questa opzione per forzare la disconnessione dei dispositivi client.

`dockerOptions`  
(Facoltativo) Configura questa opzione solo sui sistemi operativi Linux per aggiungere parametri alla riga di comando Docker. Ad esempio, per mappare porte aggiuntive, usa il parametro `-p` Docker:  

```
"-p 1883:1883"
```

**Example Esempio: aggiornamento di un file di configurazione v1.x alla v2.x**  
L'esempio seguente mostra le modifiche necessarie per aggiornare un file di configurazione v1.x alla versione 2.x.  
Il file di configurazione della versione 1.x:  

```
{
    "emqx": {
        "listener.ssl.external": "443",
        "listener.ssl.external.max_connections": "1024000",
        "listener.ssl.external.max_conn_rate": "500",
        "listener.ssl.external.rate_limit": "50KB,5s",
        "listener.ssl.external.handshake_timeout": "15s",
        "log.level": "warning"
    },
    "mergeConfigurationFiles": {
        "etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n"
    }
}
```
Il file di configurazione equivalente per la v2:  

```
{
    "emqxConfig": {
        "listeners": {
            "ssl": {
                "default": {
                   "bind": "8883",
                   "max_connections": "1024000",
                   "max_conn_rate": "500",
                   "ssl_options": {
                        "handshake_timeout": "15s"
                   }
                }
            }
        },
        "log": {
            "console": {
              "enable": true,
              "level": "warning"
            }
        }
    },
    "authMode": "enabled"
}
```
Non esiste un equivalente alla voce di `listener.ssl.external.rate_limit` configurazione. L'opzione `use_greengrass_managed_certificates` di configurazione è stata rimossa.

**Example Esempio: imposta una nuova porta per il broker**  
L'esempio seguente modifica la porta su cui opera il broker MQTT dalla porta predefinita 8883 alla porta 1234. Se utilizzi Linux, includi il `dockerOptions` campo.  

```
{
  "emqxConfig": {
    "listeners": {
      "ssl": {
        "default": {
          "bind": 1234
        }
      }
    }
  },
  "dockerOptions": "-p 1234:1234"
}
```

**Example Esempio: modifica il livello di log del broker MQTT**  
L'esempio seguente modifica il livello di log del broker MQTT in. `debug` È possibile scegliere tra i seguenti livelli di registro:  
+ `debug`
+ `info`
+ `notice`
+ `warning`
+ `error`
+ `critical`
+ `alert`
+ `emergency`
Il livello di registro predefinito è`warning`.  

```
{
  "emqxConfig": {
    "log": {
      "console": {
         "level": "debug"
      }
    }
  }
}
```

**Example Esempio: abilitare il pannello di controllo EMQX**  
L'esempio seguente abilita la dashboard EMQX in modo da poter monitorare e gestire il broker. Se utilizzi Linux, includi il `dockerOptions` campo.   

```
{
  "emqxConfig": {
    "dashboard": {
      "listeners": {
        "http": {
          "bind": 18083
        }
      }
    }
  },
  "dockerOptions": "-p 18083:18083"
}
```

------
#### [ 1.0.0 - 1.2.2 ]

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare quando si distribuisce il componente.

`emqx`  
(Facoltativo) La configurazione del [broker EMQX MQTT](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html) da utilizzare. È possibile configurare un sottoinsieme di opzioni di configurazione EMQX in questo componente.  
Questo oggetto contiene le seguenti informazioni:    
`listener.ssl.external`  
(Facoltativo) La porta in cui opera il broker MQTT.  
<a name="mqtt-broker-configuration-mqtt-bridge-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente bridge MQTT](mqtt-bridge-component.md) per inoltrare messaggi MQTT ad altri broker, è necessario utilizzare MQTT bridge v2.1.0 o versione successiva. Configuralo per utilizzare la porta su cui opera il broker MQTT.  
<a name="mqtt-broker-configuration-ip-detector-requirement"></a>Se si specifica una porta diversa e si utilizza il [componente IP detector](ip-detector-component.md) per gestire gli endpoint del broker MQTT, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta su cui opera il broker MQTT.
Impostazione predefinita: `8883`  
`listener.ssl.external.max_connections`  
(Facoltativo) Il numero massimo di connessioni simultanee supportate dal broker MQTT.  
Impostazione predefinita: `1024000`  
`listener.ssl.external.max_conn_rate`  
(Facoltativo) Il numero massimo di nuove connessioni al secondo che il broker MQTT può ricevere.  
Impostazione predefinita: `500`  
`listener.ssl.external.rate_limit`  
(Facoltativo) Il limite di larghezza di banda per tutte le connessioni al broker MQTT. Specificate la larghezza di banda e la durata di tale larghezza di banda separate da una virgola (`,`) nel seguente formato:. `bandwidth,duration` Ad esempio, è possibile specificare di `50KB,5s` limitare il broker MQTT a 50 kilobyte (KB) di dati ogni 5 secondi.  
`listener.ssl.external.handshake_timeout`  
(Facoltativo) La quantità di tempo che il broker MQTT attende per completare l'autenticazione di una nuova connessione.  
Impostazione predefinita: `15s`  
`mqtt.max_packet_size`  
(Facoltativo) La dimensione massima di un messaggio MQTT.  
Impostazione predefinita: `268435455` (256 MB meno 1)  
`log.level`  
(Facoltativo) Il livello di log per il broker MQTT. Seleziona una delle opzioni seguenti:  
+ `debug`
+ `info`
+ `notice`
+ `warning`
+ `error`
+ `critical`
+ `alert`
+ `emergency`
Il livello di registro predefinito è`warning`.

`requiresPrivilege`  
(Facoltativo) Sui dispositivi principali Linux, è possibile specificare di eseguire il broker EMQX MQTT senza privilegi di root o amministratore. Se si imposta questa opzione su`false`, l'utente di sistema che esegue questo componente deve essere un membro del gruppo. `docker`  
Impostazione predefinita: `true`

`startupTimeoutSeconds`  
(Facoltativo) Il tempo massimo in secondi per l'avvio del broker EMQX MQTT. Lo stato del componente cambia `BROKEN` se supera questo timeout.  
Impostazione predefinita: `90`

`ipcTimeoutSeconds`  
(Facoltativo) Il tempo massimo, in secondi, impiegato dal componente per attendere che il nucleo Greengrass risponda alle richieste di comunicazione tra processi (IPC). Aumentate questo numero se questo componente segnala errori di timeout quando verifica se un dispositivo client è autorizzato.  
Impostazione predefinita: `5`

`crtLogLevel`  
(Facoltativo) Il livello di registro per la libreria AWS Common Runtime (CRT).  
Il valore predefinito è il livello di log del broker EMQX MQTT (in). `log.level` `emqx`

`restartIdentifier`  
(Facoltativo) Configurare questa opzione per riavviare il broker EMQX MQTT. Quando questo valore di configurazione cambia, questo componente riavvia il broker MQTT. È possibile utilizzare questa opzione per forzare la disconnessione dei dispositivi client.

`dockerOptions`  
(Facoltativo) Configura questa opzione solo sui sistemi operativi Linux per aggiungere parametri alla riga di comando Docker. Ad esempio, per mappare porte aggiuntive, usa il parametro `-p` Docker:  

```
"-p 1883:1883"
```

`mergeConfigurationFiles`  
(Facoltativo) Configurate questa opzione per aggiungere o sostituire i valori predefiniti nei file di configurazione EMQX specificati. *Per informazioni sui file di configurazione e sui relativi formati, vedere [Configurazione](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html) nella documentazione di EMQX 4.0.* I valori specificati vengono aggiunti al file di configurazione.   
L'esempio seguente aggiorna il `etc/emqx.conf` file.  

```
"mergeConfigurationFiles": {
    "etc/emqx.conf": "broker.sys_interval=30s\nbroker.sys_heartbeat=10s"
},
```
Oltre ai file di configurazione supportati da EMQX, Greengrass supporta un file che configura il plugin di autenticazione Greengrass per EMQX chiamato. `etc/plugins/aws_greengrass_emqx_auth.conf` Sono supportate due opzioni e. `auth_mode` `use_greengrass_managed_certificates` Per utilizzare un altro provider di autenticazione, imposta l'`auth_mode`opzione su una delle seguenti:  
+ `enabled`— (Impostazione predefinita) Utilizza il provider di autenticazione e autorizzazione Greengrass.
+ `bypass_on_failure`— Utilizzare il provider di autenticazione Greengrass, quindi utilizzare tutti i provider di autenticazione rimanenti nella catena di provider EMQX se Greengrass nega l'autenticazione o l'autorizzazione.
+ `bypass`— Il provider Greengrass è disabilitato. L'autenticazione e l'autorizzazione vengono quindi gestite dalla catena di fornitori EMQX.
In caso `use_greengrass_managed_certificates` affermativo`true`, questa opzione indica che Greengrass gestisce i certificati TLS del broker. Se`false`, indica che i certificati vengono forniti tramite un'altra fonte.  
L'esempio seguente aggiorna le impostazioni predefinite nel `etc/plugins/aws_greengrass_emqx_auth.conf` file di configurazione.  

```
"mergeConfigurationFiles": {
    "etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n"
  },
```
`aws.greengrass.clientdevices.mqtt.EMQX`consente di configurare opzioni sensibili alla sicurezza. Questi includono impostazioni TLS, autenticazione e provider di autorizzazione. La configurazione consigliata è la configurazione predefinita che utilizza l'autenticazione TLS reciproca e il provider Greengrass Client Device Auth.

`replaceConfigurationFiles`  
(Facoltativo) Configurate questa opzione per sostituire i file di configurazione EMQX specificati. I valori specificati sostituiscono l'intero file di configurazione esistente. Non è possibile specificare il `etc/emqx.conf` file in questa sezione. È necessario utilizzare `mergeConfigurationFile` per modificare`etc/emqx.conf`.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di utilizzare il broker MQTT sulla porta 443.  

```
{
  "emqx": {
    "listener.ssl.external": "443",
    "listener.ssl.external.max_connections": "1024000",
    "listener.ssl.external.max_conn_rate": "500",
    "listener.ssl.external.rate_limit": "50KB,5s",
    "listener.ssl.external.handshake_timeout": "15s",
    "log.level": "warning"
  },
  "requiresPrivilege": "true",
  "startupTimeoutSeconds": "90",
  "ipcTimeoutSeconds": "5"
}
```

------

## File di registro locale
<a name="mqtt-broker-emqx-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.log -Tail 10 -Wait
  ```

------

## Licenze
<a name="mqtt-broker-emqx-component-licenses"></a>

Nei sistemi operativi Windows, questo software include codice distribuito in base alle [Condizioni di licenza software Microsoft - Microsoft Visual Studio Community 2022](https://visualstudio.microsoft.com/license-terms/vs2022-ga-community). Scaricando questo software, l'utente accetta le condizioni di licenza del codice.

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="mqtt-broker-emqx-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.

------
#### [ v2.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html)  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html)  | 
|  2.0.1  |  Versione aggiornata per la versione 2.5.0 di [autenticazione dei dispositivi client](client-device-auth-component.md).  | 
| 2.0.0 | Questa versione del broker MQTT 5 (EMQX) prevede parametri di configurazione diversi rispetto alla versione 1.x. Se si utilizza una configurazione non predefinita per la versione 1.x, è necessario aggiornare la configurazione del componente per la 2.x. Per ulteriori informazioni, consulta [Configurazione](#mqtt-broker-emqx-component-configuration). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | 

------
#### [ v1.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html)  | 
|  1.2.2  |  [Versione aggiornata per la versione 2.4.0 di autenticazione del dispositivo client.](client-device-auth-component.md)  | 
|  1.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html)  | 
|  1.2.0  |  Aggiunge il supporto per le catene di certificati.  | 
|  1.1.0  | <a name="changelog-emqx-1.1.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | 
|  1.0.1  |  Risolve un problema durante l'handshake TLS che impediva la connessione di alcuni client MQTT.  | 
|  1.0.0  |  Versione iniziale.  | 

------

# Emettitore di telemetria Nucleus
<a name="nucleus-emitter-component"></a>

Il nucleus telemetry emitter component (`aws.greengrass.telemetry.NucleusEmitter`) raccoglie dati di telemetria sullo stato del sistema e li pubblica continuamente su un argomento locale e su un argomento MQTT. AWS IoT Core Questo componente consente di raccogliere dati di telemetria di sistema in tempo reale sui dispositivi principali Greengrass. Per informazioni sull'agente di telemetria Greengrass che pubblica i dati di telemetria di sistema su Amazon, consulta. EventBridge [Raccogli dati di telemetria sanitaria del sistema dai dispositivi principali AWS IoT Greengrass](telemetry.md)

Per impostazione predefinita, il componente dell'emettitore di telemetria Nucleus pubblica i dati di telemetria ogni 60 secondi nel seguente argomento locale. publish/subscribe 

```
$local/greengrass/telemetry
```

Per impostazione predefinita, il componente dell'emettitore di telemetria nucleus non viene pubblicato su un argomento MQTT. AWS IoT Core È possibile configurare questo componente per la pubblicazione su un argomento AWS IoT Core MQTT quando lo si distribuisce. [L'uso di un argomento MQTT per pubblicare dati su Cloud AWS è soggetto a prezzi.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/)

<a name="greengrass-software-catalog-influxdb-telemetry-publisher"></a>AWS IoT Greengrass fornisce diversi [componenti della community](greengrass-software-catalog.md) per aiutarti ad analizzare e visualizzare i dati di telemetria localmente sul tuo dispositivo principale utilizzando InfluxDB e Grafana. Questi componenti utilizzano i dati di telemetria del componente emettitore del nucleo. [Per ulteriori informazioni, consultate il README per il componente publisher InfluxDB.](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher)

**Topics**
+ [Versioni](#nucleus-emitter-component-versions)
+ [Tipo](#nucleus-emitter-component-type)
+ [Sistema operativo](#nucleus-emitter-component-os-support)
+ [Dipendenze](#nucleus-emitter-component-dependencies)
+ [Configurazione](#nucleus-emitter-component-configuration)
+ [Dati di output](#nucleus-emitter-component-output-data)
+ [Utilizzo](#nucleus-emitter-component-usage)
+ [File di registro locale](#nucleus-emitter-component-log-file)
+ [Changelog](#nucleus-emitter-component-changelog)

## Versioni
<a name="nucleus-emitter-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.0.x

## Tipo
<a name="nucleus-emitter-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="nucleus-emitter-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Dipendenze
<a name="nucleus-emitter-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#nucleus-emitter-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.0.12 ]

La tabella seguente elenca le dipendenze per la versione 1.0.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.17.0 | Flessibili | 

------
#### [ 1.0.11 ]

La tabella seguente elenca le dipendenze per la versione 1.0.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.16.0  | Rigidi | 

------
#### [ 1.0.10 ]

La tabella seguente elenca le dipendenze per la versione 1.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.15.0  | Rigidi | 

------
#### [ 1.0.9 ]

La tabella seguente elenca le dipendenze per la versione 1.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.14.0  | Rigidi | 

------
#### [ 1.0.8 ]

La tabella seguente elenca le dipendenze per la versione 1.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.13.0  | Rigidi | 

------
#### [ 1.0.7 ]

La tabella seguente elenca le dipendenze per la versione 1.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.12.0  | Rigidi | 

------
#### [ 1.0.6 ]

La tabella seguente elenca le dipendenze per la versione 1.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.11.0  | Rigidi | 

------
#### [ 1.0.5 ]

La tabella seguente elenca le dipendenze per la versione 1.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.10.0  | Rigidi | 

------
#### [ 1.0.4 ]

La tabella seguente elenca le dipendenze per la versione 1.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.9.0  | Rigidi | 

------
#### [ 1.0.3 ]

La tabella seguente elenca le dipendenze per la versione 1.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.8.0  | Rigidi | 

------
#### [ 1.0.2 ]

La tabella seguente elenca le dipendenze per la versione 1.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.7.0  | Rigidi | 

------
#### [ 1.0.1 ]

La tabella seguente elenca le dipendenze per la versione 1.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.6.0  | Rigidi | 

------
#### [ 1.0.0 ]

La tabella seguente elenca le dipendenze per la versione 1.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.5.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="nucleus-emitter-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`pubSubPublish`  
(Facoltativo) Definisce se pubblicare i dati di telemetria sull'argomento. `$local/greengrass/telemetry` I valori supportati sono `true` e `false`.  
Impostazione predefinita: `true`

`mqttTopic`  
(Facoltativo) L'argomento AWS IoT Core MQTT su cui questo componente pubblica i dati di telemetria.  
Imposta questo valore sull'argomento AWS IoT Core MQTT su cui desideri pubblicare i dati di telemetria. Quando questo valore è vuoto, l'emettitore del nucleo non pubblica i dati di telemetria su. Cloud AWS  
[L'uso di un argomento MQTT per pubblicare dati su è soggetto ai prezzi. Cloud AWSAWS IoT Core](https://aws.amazon.com/iot-core/pricing/)
Impostazione predefinita: `""`

`telemetryPublishIntervalMs`  
(Facoltativo) La quantità di tempo (in millisecondi) tra cui il componente pubblica i dati di telemetria. Se imposti questo valore su un valore inferiore al valore minimo supportato, il componente utilizza invece il valore minimo.  
Intervalli di pubblicazione inferiori comportano un maggiore utilizzo della CPU sul dispositivo principale. Ti consigliamo di iniziare con l'intervallo di pubblicazione predefinito e di modificarlo in base all'utilizzo della CPU del dispositivo.
Minimo: `500`  
Impostazione predefinita: `60000`

**Example Esempio: fusione e aggiornamento della configurazione**  
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione che consente la pubblicazione dei dati di telemetria ogni 5 secondi sull'argomento e sull'`$local/greengrass/telemetry`argomento MQTT. `greengrass/myTelemetry` AWS IoT Core   

```
{
  "pubSubPublish": "true",
  "mqttTopic": "greengrass/myTelemetry",
  "telemetryPublishIntervalMs": 5000
}
```

## Dati di output
<a name="nucleus-emitter-component-output-data"></a>

Questo componente pubblica le metriche di telemetria come array JSON nell'argomento seguente. 

**Argomento locale:** `$local/greengrass/telemetry`

Facoltativamente, puoi scegliere di pubblicare anche metriche di telemetria su un argomento MQTT. AWS IoT Core *Per ulteriori informazioni sugli argomenti, consultate gli argomenti [MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella Developer Guide.AWS IoT Core *

**Example Dati di esempio**  

```
[
  {
    "A": "Average",
    "N": "CpuUsage",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Percent",
    "V": 26.21981271562346
  },
  {
    "A": "Count",
    "N": "TotalNumberOfFDs",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Count",
    "V": 7316
  },
  {
    "A": "Count",
    "N": "SystemMemUsage",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Megabytes",
    "V": 10098
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStarting",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsInstalled",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStateless",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStopping",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsBroken",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsRunning",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 7
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsErrored",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsNew",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsFinished",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 2
  }
]
```<a name="telemetry-json-array-config"></a>

L'array di output contiene un elenco di metriche con le seguenti proprietà:

`A`  
Il tipo di aggregazione per la metrica.   
Per la `CpuUsage` metrica, questa proprietà è impostata su `Average` perché il valore pubblicato della metrica è la quantità media di utilizzo della CPU dall'ultimo evento di pubblicazione.  
Per tutte le altre metriche, l'emettitore del nucleo non aggrega il valore metrico e questa proprietà è impostata su. `Count`

`N`  
Nome del parametro.

`NS`  
Lo spazio dei nomi metrico.

`TS`  
Il timestamp di quando i dati sono stati raccolti.

`U`  
L'unità del valore metrico.

`V`  
Valore del parametro . 

L'emettitore del nucleo pubblica le seguenti metriche:


| Nome | Description | 
| --- | --- | 
|  **System (Sistema)**  | 
|  `SystemMemUsage`  |  La quantità di memoria attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo.  | 
|  `CpuUsage`  |  La quantità di CPU attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo.  | 
|  `TotalNumberOfFDs`  |  Il numero di descrittori di file memorizzati dal sistema operativo del dispositivo principale Greengrass. Un descrittore di file identifica in modo univoco un file aperto.  | 
|  **Nucleo Greengrass**  | 
|  `NumberOfComponentsRunning`  |  Il numero di componenti in esecuzione sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsErrored`  |  Il numero di componenti che si trovano in stato di errore sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsInstalled`  |  Il numero di componenti installati sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsStarting`  |  Il numero di componenti che si avviano sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsNew`  |  Il numero di componenti nuovi sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsStopping`  |  Il numero di componenti che si arrestano sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsFinished`  |  Il numero di componenti completati sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsBroken`  |  Il numero di componenti danneggiati sul dispositivo principale Greengrass.  | 
|  `NumberOfComponentsStateless`  |  Il numero di componenti stateless sul dispositivo principale Greengrass.  | 

## Utilizzo
<a name="nucleus-emitter-component-usage"></a>

Per utilizzare i dati di telemetria relativi allo stato del sistema, è possibile creare componenti personalizzati che si iscrivono agli argomenti in cui l'emettitore nucleare pubblica i dati di telemetria e reagire a tali dati in base alle esigenze. Poiché il componente nucleus emitter offre la possibilità di pubblicare dati di telemetria su un argomento locale, puoi abbonarti a quell'argomento e utilizzare i dati pubblicati per agire localmente sul tuo dispositivo principale. Il dispositivo principale può quindi reagire ai dati di telemetria anche quando ha una connettività limitata al cloud.

Ad esempio, è possibile configurare un componente che ascolta i dati di telemetria sull'`$local/greengrass/telemetry`argomento e inviare i dati al componente stream manager per trasmettere i dati a. Cloud AWS Per ulteriori informazioni sulla creazione di tale componente, consulta e. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md) [Crea componenti personalizzati che utilizzano stream manager](use-stream-manager-in-custom-components.md)

## File di registro locale
<a name="nucleus-emitter-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="nucleus-emitter-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.0.12  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  1.0.11  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  1.0.10  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  1.0.9  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  1.0.8  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  1.0.7  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  1.0.6  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  1.0.5  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  1.0.4  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  1.0.3  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  1.0.2  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  1.0.1  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  1.0.0  |  Versione iniziale.  | 

# Fornitore PKCS \$111
<a name="pkcs11-provider-component"></a>

[Il componente provider PKCS \$111 (`aws.greengrass.crypto.Pkcs11Provider`) consente di configurare il software AWS IoT Greengrass Core per l'utilizzo di un modulo di sicurezza hardware (HSM) tramite l'interfaccia PKCS \$111.](https://en.wikipedia.org/wiki/PKCS_11) Questo componente consente di archiviare in modo sicuro i file di certificati e chiavi private in modo che non vengano esposti o duplicati nel software. Per ulteriori informazioni, consulta [Integrazione della sicurezza hardware](hardware-security.md).

Per effettuare il provisioning di un dispositivo core Greengrass che memorizza il certificato e la chiave privata in un HSM, è necessario specificare questo componente come plug-in di provisioning quando si installa il software Core. AWS IoT Greengrass Per ulteriori informazioni, consulta [Installa il software AWS IoT Greengrass Core con provisioning manuale delle risorse](manual-installation.md).

AWS IoT Greengrass fornisce questo componente come file JAR che potete scaricare e specificare come plug-in di provisioning durante l'installazione. È possibile scaricare la versione più recente del file JAR del componente al seguente URL: [https://d2s8p88vqu9w66.cloudfront. net/releases/Pkcs11Provider/aws.greengrass.crypto.pkcs11Provider-latest.jar](https://d2s8p88vqu9w66.cloudfront.net/releases/Pkcs11Provider/aws.greengrass.crypto.Pkcs11Provider-latest.jar).

**Topics**
+ [Versioni](#pkcs11-provider-component-versions)
+ [Tipo](#pkcs11-provider-component-type)
+ [Sistema operativo](#pkcs11-provider-component-os-support)
+ [Requisiti](#pkcs11-provider-component-requirements)
+ [Dipendenze](#pkcs11-provider-component-dependencies)
+ [Configurazione](#pkcs11-provider-component-configuration)
+ [File di registro locale](#pkcs11-provider-component-log-file)
+ [Changelog](#pkcs11-provider-component-changelog)

## Versioni
<a name="pkcs11-provider-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x

## Tipo
<a name="pkcs11-provider-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="pkcs11-provider-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="pkcs11-provider-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="hardware-security-module-requirements-key"></a>Un modulo di sicurezza hardware che supporta lo schema di firma [PKCS \$11 v1.5](https://tools.ietf.org/html/rfc2313) e le chiavi RSA con chiave RSA-2048 (o superiore) o chiavi ECC.
**Nota**  <a name="hardware-security-module-requirements-key-notes"></a>
Per utilizzare un modulo di sicurezza hardware con chiavi ECC, è necessario utilizzare [Greengrass nucleus](greengrass-nucleus-component.md) v2.5.6 o versione successiva.  
Per utilizzare un modulo di sicurezza hardware e un [gestore segreto](secret-manager-component.md), è necessario utilizzare un modulo di sicurezza hardware con chiavi RSA.
+ <a name="hardware-security-module-requirements-pkcs11-provider-library"></a>Una libreria di provider PKCS \$111 che il software AWS IoT Greengrass Core può caricare in fase di esecuzione (usando libdl) per richiamare le funzioni PKCS \$111. La libreria del provider PKCS \$111 deve implementare le seguenti operazioni API PKCS \$111:
  + `C_Initialize`
  + `C_Finalize`
  + `C_GetSlotList`
  + `C_GetSlotInfo`
  + `C_GetTokenInfo`
  + `C_OpenSession`
  + `C_GetSessionInfo`
  + `C_CloseSession`
  + `C_Login`
  + `C_Logout`
  + `C_GetAttributeValue`
  + `C_FindObjectsInit`
  + `C_FindObjects`
  + `C_FindObjectsFinal`
  + `C_DecryptInit`
  + `C_Decrypt`
  + `C_DecryptUpdate`
  + `C_DecryptFinal`
  + `C_SignInit`
  + `C_Sign`
  + `C_SignUpdate`
  + `C_SignFinal`
  + `C_GetMechanismList`
  + `C_GetMechanismInfo`
  + `C_GetInfo`
  + `C_GetFunctionList`
+ <a name="hardware-security-module-requirements-slot-label"></a>Il modulo hardware deve essere risolvibile mediante l'etichetta dello slot, come definito nella specifica PKCS\$111.
+ <a name="hardware-security-module-requirements-private-key-and-certificate"></a>È necessario archiviare la chiave privata e il certificato nell'HSM nello stesso slot e devono utilizzare la stessa etichetta e lo stesso ID dell'oggetto, se l'HSM supporta l'oggetto. IDs
+ <a name="hardware-security-module-requirements-object-label"></a>Il certificato e la chiave privata devono essere risolvibili mediante etichette di oggetti.
+ <a name="hardware-security-module-requirements-private-key-permissions"></a>La chiave privata deve avere le seguenti autorizzazioni:
  + `sign`
  + `decrypt`
+ <a name="hardware-security-module-requirements-secret-manager-permissions"></a>(Facoltativo) Per utilizzare il [componente Secret Manager](secret-manager-component.md), è necessario utilizzare la versione 2.1.0 o successiva e la chiave privata deve disporre delle seguenti autorizzazioni:
  + `unwrap`
  + `wrap`
+ <a name="hardware-security-module-requirements-environment-variable"></a>(Facoltativo) Se si utilizza la TPM2 libreria e si esegue il core Greengrass come servizio, è necessario fornire una variabile di ambiente con la posizione dell'archivio PKCS \$111. L'esempio seguente è un file di servizio systemd con la variabile di ambiente richiesta:

  ```
  [Unit]
  Description=Greengrass Core
  After=network.target
  
  [Service]
  Type=simple
  PIDFile=/var/run/greengrass.pid
  Environment=TPM2_PKCS11_STORE=/path/to/store/directory
  RemainAfterExit=no
  Restart=on-failure
  RestartSec=10
  ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader
  
  [Install]
  WantedBy=multi-user.target
  ```

## Dipendenze
<a name="pkcs11-provider-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#pkcs11-provider-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.0.11 ]

La tabella seguente elenca le dipendenze per la versione 2.0.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.17.0 | Flessibili | 

------
#### [ 2.0.10 ]

La tabella seguente elenca le dipendenze per la versione 2.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.16.0  | Flessibili | 

------
#### [ 2.0.9 ]

La tabella seguente elenca le dipendenze per la versione 2.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.15.0  | Flessibili | 

------
#### [ 2.0.8 ]

La tabella seguente elenca le dipendenze per la versione 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.14.0  | Flessibili | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.13.0  | Flessibili | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.12.0  | Flessibili | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.11.0  | Flessibili | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.10.0  | Flessibili | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.9.0  | Flessibili | 

------
#### [ 2.0.2 ]

La tabella seguente elenca le dipendenze per la versione 2.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.8.0  | Flessibili | 

------
#### [ 2.0.1 ]

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.5.3 <2.7.0  | Flessibili | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.5.3 <2.6.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="pkcs11-provider-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.<a name="pkcs11-provider-component-configuration-parameters"></a>

`name`  
Un nome per la configurazione PKCS \$111.

`library`  
Il percorso assoluto del file alla libreria dell'implementazione PKCS \$111 che il software AWS IoT Greengrass Core può caricare con libdl.

`slot`  
L'ID dello slot che contiene la chiave privata e il certificato del dispositivo. Questo valore è diverso dall'indice o dall'etichetta dello slot.

`userPin`  
Il PIN utente da utilizzare per accedere allo slot.

**Example Esempio: fusione e aggiornamento della configurazione**  

```
{
  "name": "softhsm_pkcs11",
  "library": "/usr/lib/softhsm/libsofthsm2.so",
  "slot": 1,
  "userPin": "1234"
}
```

## File di registro locale
<a name="pkcs11-provider-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="pkcs11-provider-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.11  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.0.10  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.0.9  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.0.8  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.0.7  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.0.6  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.0.5  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.0.4  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.0.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.0.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.0.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.0.0  |  Versione iniziale.  | 

# Gestore segreto
<a name="secret-manager-component"></a>

Il componente secret manager (`aws.greengrass.SecretManager`) distribuisce i segreti dai dispositivi Gestione dei segreti AWS principali di Greengrass. Usa questo componente per utilizzare in modo sicuro le credenziali, come le password, nei componenti personalizzati dei tuoi dispositivi principali Greengrass. Per ulteriori informazioni su Secrets Manager, vedi [Cos'è Gestione dei segreti AWS?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) nella *Guida Gestione dei segreti AWS per l'utente*.

Per accedere ai segreti di questo componente nei componenti Greengrass personalizzati, utilizzate l'[GetSecretValue](ipc-secret-manager.md#ipc-operation-getsecretvalue)operazione in. SDK per dispositivi AWS IoT Per ulteriori informazioni, consultare [Usa il SDK per dispositivi AWS IoT per comunicare con il nucleo Greengrass, altri componenti e AWS IoT CoreComunica con il nucleo Greengrass, altri componenti e AWS IoT Core](interprocess-communication.md) e [Recupera valori segreti](ipc-secret-manager.md).

Questo componente crittografa i segreti sul dispositivo principale per proteggere le credenziali e le password fino al momento del loro utilizzo. Utilizza la chiave privata del dispositivo principale per crittografare e decrittografare i segreti.

**Topics**
+ [Versioni](#secret-manager-component-versions)
+ [Tipo](#secret-manager-component-type)
+ [Sistema operativo](#secret-manager-component-os-support)
+ [Requisiti](#secret-manager-component-requirements)
+ [Dipendenze](#secret-manager-component-dependencies)
+ [Configurazione](#secret-manager-component-configuration)
+ [File di registro locale](#secret-manager-component-log-file)
+ [Changelog](#secret-manager-component-changelog)

## Versioni
<a name="secret-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="secret-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin (`aws.greengrass.plugin`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="secret-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="secret-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire l'`secretsmanager:GetSecretValue`azione, come illustrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "secretsmanager:GetSecretValue"
        ],
        "Effect": "Allow",
        "Resource": [
        "arn:aws:secretsmanager:us-east-1:123456789012:secret:MySecret"
        ]
      }
    ]
  }
  ```

------

  ```
  ```
**Nota**  
Se utilizzi una AWS Key Management Service chiave gestita dal cliente per crittografare i segreti, anche il ruolo del dispositivo deve consentire l'azione. `kms:Decrypt`

  Per ulteriori informazioni sulle politiche IAM per Secrets Manager, consulta quanto segue nella *Guida per l'Gestione dei segreti AWS utente*:
  + [Autenticazione e controllo degli accessi per Gestione dei segreti AWS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html)
  + [Azioni, risorse e chiavi di contesto che puoi utilizzare in una policy IAM o in una policy segreta per Gestione dei segreti AWS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/reference_iam-permissions.html)
+ I componenti personalizzati devono definire una politica di autorizzazione che `aws.greengrass#GetSecretValue` consenta di ottenere i segreti archiviati con questo componente. In questa politica di autorizzazione, puoi limitare l'accesso dei componenti a segreti specifici. Per ulteriori informazioni, [consulta l'autorizzazione IPC del gestore segreto](ipc-secret-manager.md#ipc-secret-manager-authorization).
+ (Facoltativo) Se si archivia la chiave privata e il certificato del dispositivo principale in un [modulo di sicurezza hardware](hardware-security.md) (HSM), l'HSM deve supportare le chiavi RSA, la chiave privata deve disporre dell'`unwrap`autorizzazione e la chiave pubblica deve disporre dell'autorizzazione. `wrap`

### Endpoint e porte
<a name="secret-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `secretsmanager.region.amazonaws.com`  | 443 | Sì |  Scarica i segreti sul dispositivo principale.  | 

## Dipendenze
<a name="secret-manager-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#secret-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.2.7 ]

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Flessibili | 

------
#### [ 2.2.6 ]

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Flessibili | 

------
#### [ 2.2.2 – 2.2.5 ]

La tabella seguente elenca le dipendenze per le versioni da 2.2.2 a 2.2.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.13.0 <2.14.0 | Flessibili | 

------
#### [ 2.1.7 – 2.1.8 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.7 e 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | Flessibili | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Flessibili | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flessibili | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flessibili | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Flessibili | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Flessibili | 

------
#### [ 2.0.9 ]

La tabella seguente elenca le dipendenze per la versione 2.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.5.0  | Flessibili | 

------
#### [ 2.0.8 ]

La tabella seguente elenca le dipendenze per la versione 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.4.0  | Flessibili | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.3.0  | Flessibili | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.2.0  | Flessibili | 

------
#### [ 2.0.4 and 2.0.5 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.4 e 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="secret-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`periodicRefreshIntervalMin` (facoltativo)  
L'intervallo in minuti in cui questo componente sincronizza i segreti configurati sul dispositivo principale con i valori segreti più recenti del servizio. Gestione dei segreti AWS Se questo intervallo non è configurato, il gestore segreto non aggiornerà periodicamente i segreti configurati.  

```
{
  "cloudSecrets": [
    {
      "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    }
  ],
  "periodicRefreshIntervalMin" : 60
}
```

`cloudSecrets`  
Un elenco di segreti di Secrets Manager da distribuire sul dispositivo principale. È possibile specificare etichette per definire quali versioni di ogni segreto distribuire. Se non specifichi una versione, questo componente distribuisce la versione con l'etichetta di staging allegata. `AWSCURRENT` *Per ulteriori informazioni, consulta [Staging labels](https://docs.aws.amazon.com/secretsmanager/latest/userguide/terms-concepts.html#term_staging-label) nella Guida per l'Gestione dei segreti AWS utente.*  
Il componente secret manager memorizza i segreti nella cache locale. Se il valore segreto cambia in Secrets Manager, questo componente non recupera automaticamente il nuovo valore. Per aggiornare la copia locale, assegna al segreto una nuova etichetta e configura questo componente per recuperare il segreto identificato dalla nuova etichetta.  
Ogni oggetto contiene le seguenti informazioni:    
`arn`  
L'ARN del segreto da implementare. L'ARN del segreto può essere un ARN completo o un ARN parziale. Si consiglia di specificare un ARN completo anziché un ARN parziale. Per ulteriori informazioni, vedere [Ricerca di un segreto da un ARN parziale](https://docs.aws.amazon.com/secretsmanager/latest/userguide/troubleshoot.html#ARN_secretnamehyphen). Di seguito è riportato un esempio di ARN completo e ARN parziale:  
+ ARN completo: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef`
+ ARN parziale: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName`  
`labels`  
(Facoltativo) Un elenco di etichette per identificare le versioni del segreto da distribuire sul dispositivo principale.  
Ogni etichetta deve essere una stringa.

**Example Esempio: configurazione, unione, aggiornamento**  

```
{
  "cloudSecrets": [
    {
      "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    }
  ]
}
```

## File di registro locale
<a name="secret-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="secret-manager-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.2.7  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.2.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.1.8  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.1.7  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.6  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.5  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.1.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.0.9  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.8  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secret-manager-component.html)  | 
|  2.0.4  |  Versione iniziale.  | 

# Tunneling sicuro
<a name="secure-tunneling-component"></a>

Con il `aws.greengrass.SecureTunneling` componente, è possibile stabilire una comunicazione bidirezionale sicura con un dispositivo principale Greengrass situato dietro firewall limitati.

Ad esempio, immagina di avere un dispositivo core Greengrass protetto da un firewall che vieta tutte le connessioni in entrata. Il tunneling sicuro utilizza MQTT per trasferire un token di accesso al dispositivo e quindi lo utilizza WebSockets per stabilire una connessione SSH al dispositivo tramite il firewall. Con questo tunnel AWS IoT gestito, puoi aprire la connessione SSH necessaria per il tuo dispositivo. *Per ulteriori informazioni sull'utilizzo del tunneling AWS IoT sicuro per la connessione a dispositivi remoti, consulta [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) nella Developer Guide.AWS IoT *

Questo componente sottoscrive il broker di messaggi AWS IoT Core MQTT sull'`$aws/things/greengrass-core-device/tunnels/notify`argomento per ricevere notifiche di tunneling sicuro.

**Topics**
+ [Versioni](#secure-tunneling-component-versions)
+ [Tipo](#secure-tunneling-component-type)
+ [Sistema operativo](#secure-tunneling-component-os-support)
+ [Requisiti](#secure-tunneling-component-requirements)
+ [Dipendenze](#secure-tunneling-component-dependencies)
+ [Configurazione](#secure-tunneling-component-configuration)
+ [File di registro locale](#secure-tunneling-component-log-file)
+ [Licenze](#secure-tunneling-component-licenses)
+ [Utilizzo](#secure-tunneling-component-usage)
+ [Consulta anche](#secure-tunneling-component-see-also)
+ [Changelog](#secure-tunneling-component-changelog)

## Versioni
<a name="secure-tunneling-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.1.x
+ 1.0.x

## Tipo
<a name="secure-tunneling-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="secure-tunneling-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

Architetture:
+ Arm v71
+ Arm v 8 () AArch64
+ x86\$164

## Requisiti
<a name="secure-tunneling-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ Almeno 32 MB di spazio su disco disponibile per il componente di tunneling sicuro. Questo requisito non include il software di base Greengrass o altri componenti in esecuzione sullo stesso dispositivo.
+ Sono disponibili almeno 16 MB di RAM per il componente di tunneling sicuro. Questo requisito non include il software di base Greengrass o altri componenti in esecuzione sullo stesso dispositivo. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).
+ La versione 2.25 o superiore della GNU C Library (glibc) con un kernel Linux 3.2 o superiore è richiesta per la versione 1.0.12 e successive del componente di tunneling sicuro. Le versioni del sistema operativo e delle librerie che hanno superato la data di scadenza del supporto a lungo termine non sono supportate. È necessario utilizzare un sistema operativo e delle librerie con supporto a lungo termine.
+ Sia il sistema operativo che il runtime Java devono essere installati a 64 bit.
+ [Python](https://www.python.org/) 3.5 o successivo installato sul dispositivo principale Greengrass e aggiunto alla variabile di ambiente PATH.
+ `libcrypto.so.1.1`installato sul dispositivo principale Greengrass e aggiunto alla variabile di ambiente PATH.
+ Apri il traffico in uscita sulla porta 443 del dispositivo principale Greengrass.
+ Attiva il supporto per il servizio di comunicazione che desideri utilizzare per comunicare con il dispositivo principale Greengrass. Ad esempio, per aprire una connessione SSH al dispositivo, è necessario attivare SSH su quel dispositivo.

### Endpoint e porte
<a name="secure-tunneling-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `data.tunneling.iot.region.amazonaws.com`  | 443 | Sì |  Stabilisci tunnel sicuri.  | 

## Dipendenze
<a name="secure-tunneling-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#secure-tunneling-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.0.19 – 1.1.3 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.19 a 1.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <3.0.0  | Flessibili | 

------
#### [ 1.0.18 ]

La tabella seguente elenca le dipendenze per la versione 1.0.18 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.13.0  | Flessibili | 

------
#### [ 1.0.16 – 1.0.17 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.16 a 1.0.17 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.12.0  | Flessibili | 

------
#### [ 1.0.14 – 1.0.15 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.14 a 1.0.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.11.0  | Flessibili | 

------
#### [ 1.0.11 – 1.0.13 ]

La tabella seguente elenca le dipendenze per le versioni 1.0.11 - 1.0.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.10.0  | Flessibili | 

------
#### [ 1.0.10 ]

La tabella seguente elenca le dipendenze per la versione 1.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.9.0  | Flessibili | 

------
#### [ 1.0.9 ]

La tabella seguente elenca le dipendenze per la versione 1.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.8.0  | Flessibili | 

------
#### [ 1.0.8 ]

La tabella seguente elenca le dipendenze per la versione 1.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.7.0  | Flessibili | 

------
#### [ 1.0.5 - 1.0.7 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.5 a 1.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.6.0  | Flessibili | 

------
#### [ 1.0.4 ]

La tabella seguente elenca le dipendenze per la versione 1.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.5.0  | Flessibili | 

------
#### [ 1.0.3 ]

La tabella seguente elenca le dipendenze per la versione 1.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.4.0  | Flessibili | 

------
#### [ 1.0.2 ]

La tabella seguente elenca le dipendenze per la versione 1.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.3.0  | Flessibili | 

------
#### [ 1.0.1 ]

La tabella seguente elenca le dipendenze per la versione 1.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.2.0  | Flessibili | 

------
#### [ 1.0.0 ]

La tabella seguente elenca le dipendenze per la versione 1.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="secure-tunneling-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`OS_DIST_INFO`  
(Facoltativo) Il sistema operativo del dispositivo principale. Per impostazione predefinita, il componente tenta di identificare automaticamente il sistema operativo in esecuzione sul dispositivo principale. Se il componente non si avvia con il valore predefinito, utilizzate questo valore per specificare il sistema operativo. Per un elenco dei sistemi operativi supportati per questo componente, vedere[Requisiti per il dispositivo](greengrass-nucleus-component.md#greengrass-v2-requirements).  
Questo valore può essere uno dei seguenti:`auto`,`ubuntu`,`amzn2`,`raspberrypi`.  
Impostazione predefinita: `auto`

`accessControl`  
(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di sottoscrivere l'argomento delle notifiche di tunneling sicuro.   
Non modificate questo parametro di configurazione se la distribuzione è destinata a un gruppo di oggetti. Se la distribuzione riguarda un singolo dispositivo core e desideri limitarne l'abbonamento all'argomento del dispositivo, specifica il nome dell'oggetto del dispositivo principale. Nel `resources` valore della politica di autorizzazione del dispositivo, sostituisci la wildcard dell'argomento MQTT con il nome dell'oggetto del dispositivo. 

```
{
  "aws.greengrass.ipc.mqttproxy": {
    "aws.iot.SecureTunneling:mqttproxy:1": {
      "policyDescription": "Access to tunnel notification pubsub topic",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "$aws/things/+/tunnels/notify"
      ]
    }
  }
}
```

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di consentire a questo componente di aprire tunnel sicuri su un dispositivo principale denominato **MyGreengrassCore** che esegue Ubuntu.  

```
{
  "OS_DIST_INFO": "ubuntu",
  "accessControl": {
    "aws.greengrass.ipc.mqttproxy": {
      "aws.iot.SecureTunneling:mqttproxy:1": {
        "policyDescription": "Access to tunnel notification pubsub topic",
        "operations": [
          "aws.greengrass#SubscribeToIoTCore"
        ],
        "resources": [
          "$aws/things/MyGreengrassCore/tunnels/notify"
        ]
      }
    }
  }
}
```

## File di registro locale
<a name="secure-tunneling-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.SecureTunneling.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SecureTunneling.log
  ```

## Licenze
<a name="secure-tunneling-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:
+ [AWS IoT Device Client /Apache](https://github.com/awslabs/aws-iot-device-client) License 2.0
+ [SDK per dispositivi AWS IoT per Java](https://github.com/aws/aws-greengrass-core-sdk-java/)/Apache License 2.0
+ [Licenza gson/Apache](https://github.com/google/gson) 2.0
+ [log4j /Apache](https://logging.apache.org/log4j/2.x/) Licenza 2.0
+ [slf4j /Apache Licenza 2.0](http://www.slf4j.org/)

## Utilizzo
<a name="secure-tunneling-component-usage"></a>

Per utilizzare il componente di tunneling sicuro sul tuo dispositivo, procedi come segue:

1. Implementa il componente di tunneling sicuro sul tuo dispositivo.

1. Apri la [AWS IoT console](https://console.aws.amazon.com/iot). **Dal menu a sinistra, scegli **Azioni remote**, quindi scegli Tunnel sicuri.**

1. Crea un tunnel per il tuo dispositivo Greengrass. 

1. Scarica il token di accesso sorgente.

1. Usa il proxy locale con il token di accesso sorgente per connetterti alla tua destinazione. Per ulteriori informazioni, consulta [Come utilizzare il proxy locale](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) nella *Guida per gli AWS IoT sviluppatori*.

## Consulta anche
<a name="secure-tunneling-component-see-also"></a>
+ [AWS IoT tunneling sicuro nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) *Guide AWS IoT *
+ [Come usare il proxy locale](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) *nella Developer Guide AWS IoT *

## Changelog
<a name="secure-tunneling-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.2  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.19  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  Se utilizzate il proxy locale Secure Tunneling come client di origine del tunnel, non aggiornate il componente a questa versione prima di aver aggiornato anche il proxy locale alla versione 3.1.1 o successiva.   | 
|  1.0.18  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  1.0.17  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.16  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  1.0.15  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.14  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  1.0.13  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.12  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.11  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  1.0.10  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  1.0.9  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  1.0.8  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  1.0.7  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.6  |  Questa versione contiene correzioni di bug.  | 
|  1.0.5  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  1.0.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  1.0.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  1.0.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  1.0.1  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  1.0.0  |  Versione iniziale.  | 

# Gestore delle ombre
<a name="shadow-manager-component"></a>

Il componente shadow manager (`aws.greengrass.ShadowManager`) abilita il servizio shadow locale sul dispositivo principale. Il servizio shadow locale consente ai componenti di utilizzare la comunicazione tra processi per [interagire con le ombre locali](ipc-local-shadows.md). Il componente shadow manager gestisce l'archiviazione dei documenti shadow locali e gestisce anche la sincronizzazione degli stati shadow locali con il servizio AWS IoT Device Shadow.

Per ulteriori informazioni su come i dispositivi core Greengrass possono interagire con le ombre, vedere. [Interagisci con le ombre dei dispositivi](interact-with-shadows.md)

**Topics**
+ [Versioni](#shadow-manager-component-versions)
+ [Tipo](#shadow-manager-component-type)
+ [Sistema operativo](#shadow-manager-component-os-support)
+ [Requisiti](#shadow-manager-component-requirements)
+ [Dipendenze](#shadow-manager-component-dependencies)
+ [Configurazione](#shadow-manager-component-configuration)
+ [File di registro locale](#shadow-manager-component-log-file)
+ [Changelog](#shadow-manager-component-changelog)

## Versioni
<a name="shadow-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="shadow-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin (`aws.greengrass.plugin`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="shadow-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="shadow-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ (Facoltativo) Per sincronizzare le ombre con il servizio AWS IoT Device Shadow, la policy AWS IoT del dispositivo principale di Greengrass deve consentire le AWS IoT Core seguenti azioni di policy ombra:
  + `iot:GetThingShadow`
  + `iot:UpdateThingShadow`
  + `iot:DeleteThingShadow`

  Per ulteriori informazioni su queste AWS IoT Core politiche, consulta le [azioni AWS IoT Core politiche nella Guida](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) per gli *AWS IoT sviluppatori*.

  Per ulteriori informazioni sulla AWS IoT politica minima, vedere [AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali](device-auth.md#greengrass-core-minimal-iot-policy)
+ Il componente shadow manager è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="shadow-manager-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#shadow-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.3.13 ]

La tabella seguente elenca le dipendenze per la versione 2.3.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Flessibili | 

------
#### [ 2.3.12 ]

La tabella seguente elenca le dipendenze per la versione 2.3.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Flessibili | 

------
#### [ 2.3.11 ]

La tabella seguente elenca le dipendenze per la versione 2.3.11 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Flessibili | 

------
#### [ 2.3.10 ]

La tabella seguente elenca le dipendenze per la versione 2.3.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Flessibili | 

------
#### [ 2.3.9 ]

La tabella seguente elenca le dipendenze per la versione 2.3.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.14.0 | Flessibili | 

------
#### [ 2.3.5 – 2.3.8 ]

La tabella seguente elenca le dipendenze per le versioni da 2.3.5 a 2.3.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | Flessibili | 

------
#### [ 2.3.3 and 2.3.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.3 e 2.3.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Flessibili | 

------
#### [ 2.3.2 ]

La tabella seguente elenca le dipendenze per la versione 2.3.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flessibili | 

------
#### [ 2.3.0 and 2.3.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flessibili | 

------
#### [ 2.2.3 and 2.2.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.2.3 e 2.2.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <3.0.0 | Flessibili | 

------
#### [ 2.2.2 ]

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Flessibili | 

------
#### [ 2.2.1 ]

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Flessibili | 

------
#### [ 2.1.1 and 2.2.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.1 e 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Flessibili | 

------
#### [ 2.0.5 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.5 a 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Flessibili | 

------
#### [ 2.0.3 and 2.0.4 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.3 e 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Flessibili | 

------
#### [ 2.0.1 and 2.0.2 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.1 e 2.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Flessibili | 

------
#### [ 2.0.0 ]

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="shadow-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.3.x ]

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.  
Questo oggetto contiene le seguenti informazioni.    
`type`  
(Facoltativo) Il tipo di strategia utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:  
+ `realTime`— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
+ `periodic`— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il `delay` parametro di configurazione.
Impostazione predefinita: `realTime`  
`delay`  
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. `periodic`  
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. `periodic`

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con. Cloud AWS  
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con. Cloud AWS
Questo oggetto contiene le seguenti informazioni.    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.    
`classic`  
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con. Cloud AWS Se non volete sincronizzare la classica ombra del dispositivo, impostatela su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.  
Il AWS IoT Greengrass servizio utilizza lo shadow `AWSManagedGreengrassV2Deployment` denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'`shadowDocuments`oggetto.  
Se si specifica un `shadowDocumentsMap` oggetto, non è necessario specificare un `shadowDocuments` oggetto.
Ogni oggetto contiene le seguenti informazioni:    
*`thingName`*  
La configurazione shadow *thingName* per questa configurazione shadow.    
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su`false`.  
`namedShadows`  
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo invece di utilizzare il `shadowDocumentsMap` parametro.  
Se si specifica un `shadowDocuments` oggetto, non è necessario specificare un `shadowDocumentsMap` oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.     
`thingName`  
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.   
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`direction`  
(Facoltativo) La direzione in cui sincronizzare le ombre tra il servizio shadow locale e il. Cloud AWSÈ possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni a. Cloud AWS Seleziona una delle opzioni seguenti:  
+ `betweenDeviceAndCloud`— Sincronizza le ombre tra il servizio shadow locale e il. Cloud AWS
+ `deviceToCloud`— Invia gli aggiornamenti shadow dal servizio shadow locale al e ignora gli aggiornamenti shadow provenienti da. Cloud AWS Cloud AWS
+ `cloudToDevice`— Ricevi aggiornamenti shadow dal Cloud AWS servizio shadow locale e non inviali dal servizio shadow locale a Cloud AWS.
Impostazione predefinita: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste del servizio shadow.  
Questo oggetto contiene le seguenti informazioni.    
`maxOutboundSyncUpdatesPerSecond`  
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.   
Impostazione predefinita: 100 richieste/secondo  
`maxTotalLocalRequestsRate`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.   
Impostazione predefinita: 200 richieste/secondo  
`maxLocalRequestsPerSecondPerThing`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.   
Impostazione predefinita: 20 requests/second per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.   
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.  
Impostazione predefinita: 8192 byte  
Massimo: 30720 byte

**Example Esempio: aggiornamento di fusione della configurazione**  
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione con tutti i parametri di configurazione disponibili per il componente shadow manager.  

```
{
   "strategy":{
      "type":"periodic",
      "delay":300
   },
   "synchronize":{
      "shadowDocumentsMap":{
         "MyDevice1":{
            "classic":false,
            "namedShadows":[
               "MyShadowA",
               "MyShadowB"
            ]
         },
         "MyDevice2":{
            "classic":true,
            "namedShadows":[]
         }
      },
      "direction":"betweenDeviceAndCloud"
   },
   "rateLimits":{
      "maxOutboundSyncUpdatesPerSecond":100,
      "maxTotalLocalRequestsRate":200,
      "maxLocalRequestsPerSecondPerThing":20
   },
   "shadowDocumentSizeLimitBytes":8192
}
```

------
#### [ 2.2.x ]

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.  
Questo oggetto contiene le seguenti informazioni.    
`type`  
(Facoltativo) Il tipo di strategia utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:  
+ `realTime`— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
+ `periodic`— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il `delay` parametro di configurazione.
Impostazione predefinita: `realTime`  
`delay`  
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. `periodic`  
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. `periodic`

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con. Cloud AWS  
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con. Cloud AWS
Questo oggetto contiene le seguenti informazioni.    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.    
`classic`  
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con. Cloud AWS Se non volete sincronizzare la classica ombra del dispositivo, impostatela su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.  
Il AWS IoT Greengrass servizio utilizza lo shadow `AWSManagedGreengrassV2Deployment` denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'`shadowDocuments`oggetto.  
Se si specifica un `shadowDocumentsMap` oggetto, non è necessario specificare un `shadowDocuments` oggetto.
Ogni oggetto contiene le seguenti informazioni:    
*`thingName`*  
La configurazione shadow *thingName* per questa configurazione shadow.    
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su`false`.  
`namedShadows`  
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo invece di utilizzare il `shadowDocumentsMap` parametro.  
Se si specifica un `shadowDocuments` oggetto, non è necessario specificare un `shadowDocumentsMap` oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.     
`thingName`  
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.   
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`direction`  
(Facoltativo) La direzione in cui sincronizzare le ombre tra il servizio shadow locale e il. Cloud AWSÈ possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni a. Cloud AWS Seleziona una delle opzioni seguenti:  
+ `betweenDeviceAndCloud`— Sincronizza le ombre tra il servizio shadow locale e il. Cloud AWS
+ `deviceToCloud`— Invia gli aggiornamenti shadow dal servizio shadow locale al e ignora gli aggiornamenti shadow provenienti da. Cloud AWS Cloud AWS
+ `cloudToDevice`— Ricevi aggiornamenti shadow dal Cloud AWS servizio shadow locale e non inviali dal servizio shadow locale a Cloud AWS.
Impostazione predefinita: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste del servizio shadow.  
Questo oggetto contiene le seguenti informazioni.    
`maxOutboundSyncUpdatesPerSecond`  
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.   
Impostazione predefinita: 100 richieste/secondo  
`maxTotalLocalRequestsRate`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.   
Impostazione predefinita: 200 richieste/secondo  
`maxLocalRequestsPerSecondPerThing`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.   
Impostazione predefinita: 20 requests/second per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.   
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.  
Impostazione predefinita: 8192 byte  
Massimo: 30720 byte

**Example Esempio: aggiornamento di fusione della configurazione**  
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione con tutti i parametri di configurazione disponibili per il componente shadow manager.  

```
{
   "strategy":{
      "type":"periodic",
      "delay":300
   },
   "synchronize":{
      "shadowDocumentsMap":{
         "MyDevice1":{
            "classic":false,
            "namedShadows":[
               "MyShadowA",
               "MyShadowB"
            ]
         },
         "MyDevice2":{
            "classic":true,
            "namedShadows":[]
         }
      },
      "direction":"betweenDeviceAndCloud"
   },
   "rateLimits":{
      "maxOutboundSyncUpdatesPerSecond":100,
      "maxTotalLocalRequestsRate":200,
      "maxLocalRequestsPerSecondPerThing":20
   },
   "shadowDocumentSizeLimitBytes":8192
}
```

------
#### [ 2.1.x ]

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.  
Questo oggetto contiene le seguenti informazioni.    
`type`  
(Facoltativo) Il tipo di strategia utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:  
+ `realTime`— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
+ `periodic`— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il `delay` parametro di configurazione.
Impostazione predefinita: `realTime`  
`delay`  
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. `periodic`  
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. `periodic`

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con. Cloud AWS  
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con. Cloud AWS
Questo oggetto contiene le seguenti informazioni.    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.    
`classic`  
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con. Cloud AWS Se non volete sincronizzare la classica ombra del dispositivo, impostatela su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.  
Il AWS IoT Greengrass servizio utilizza lo shadow `AWSManagedGreengrassV2Deployment` denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'`shadowDocuments`oggetto.  
Se si specifica un `shadowDocumentsMap` oggetto, non è necessario specificare un `shadowDocuments` oggetto.
Ogni oggetto contiene le seguenti informazioni:    
*`thingName`*  
La configurazione shadow *thingName* per questa configurazione shadow.    
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su`false`.  
`namedShadows`  
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo invece di utilizzare il `shadowDocumentsMap` parametro.  
Se si specifica un `shadowDocuments` oggetto, non è necessario specificare un `shadowDocumentsMap` oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.     
`thingName`  
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.   
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste di servizi shadow.  
Questo oggetto contiene le seguenti informazioni.    
`maxOutboundSyncUpdatesPerSecond`  
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.   
Impostazione predefinita: 100 richieste/secondo  
`maxTotalLocalRequestsRate`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.   
Impostazione predefinita: 200 richieste/secondo  
`maxLocalRequestsPerSecondPerThing`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.   
Impostazione predefinita: 20 requests/second per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.   
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.  
Impostazione predefinita: 8192 byte  
Massimo: 30720 byte

**Example Esempio: aggiornamento di fusione della configurazione**  
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione con tutti i parametri di configurazione disponibili per il componente shadow manager.  

```
{
   "strategy":{
      "type":"periodic",
      "delay":300
   },
   "synchronize":{
      "shadowDocumentsMap":{
         "MyDevice1":{
            "classic":false,
            "namedShadows":[
               "MyShadowA",
               "MyShadowB"
            ]
         },
         "MyDevice2":{
            "classic":true,
            "namedShadows":[]
         }
      },
      "direction":"betweenDeviceAndCloud"
   },
   "rateLimits":{
      "maxOutboundSyncUpdatesPerSecond":100,
      "maxTotalLocalRequestsRate":200,
      "maxLocalRequestsPerSecondPerThing":20
   },
   "shadowDocumentSizeLimitBytes":8192
}
```

------
#### [ 2.0.x ]

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con. Cloud AWS  
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con. Cloud AWS
Questo oggetto contiene le seguenti informazioni.    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.    
`classic`  
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con. Cloud AWS Se non volete sincronizzare la classica ombra del dispositivo, impostatela su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.  
Il AWS IoT Greengrass servizio utilizza lo shadow `AWSManagedGreengrassV2Deployment` denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'`shadowDocuments`oggetto.  
Se si specifica un `shadowDocumentsMap` oggetto, non è necessario specificare un `shadowDocuments` oggetto.
Ogni oggetto contiene le seguenti informazioni:    
*`thingName`*  
La configurazione shadow *thingName* per questa configurazione shadow.    
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su`false`.  
`namedShadows`  
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo invece di utilizzare il `shadowDocumentsMap` parametro.  
Se si specifica un `shadowDocuments` oggetto, non è necessario specificare un `shadowDocumentsMap` oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.     
`thingName`  
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.   
`classic`  
(Facoltativo) Se non desideri sincronizzare la classica ombra del dispositivo per il `thingName` dispositivo, impostala su. `false`  
Impostazione predefinita: `true`  
`namedShadows`  
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste di servizi shadow.  
Questo oggetto contiene le seguenti informazioni.    
`maxOutboundSyncUpdatesPerSecond`  
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.   
Impostazione predefinita: 100 richieste/secondo  
`maxTotalLocalRequestsRate`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.   
Impostazione predefinita: 200 richieste/secondo  
`maxLocalRequestsPerSecondPerThing`  
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.   
Impostazione predefinita: 20 requests/second per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.   
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'[API AWS IoT Device Shadow Service](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in *Riferimenti generali di Amazon Web Services*.  
Impostazione predefinita: 8192 byte  
Massimo: 30720 byte

**Example Esempio: aggiornamento di fusione della configurazione**  
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione con tutti i parametri di configurazione disponibili per il componente shadow manager.  

```
{
  "synchronize": {
    "coreThing": {
      "classic": true,
      "namedShadows": [
        "MyCoreShadowA",
        "MyCoreShadowB"
      ]
    },
    "shadowDocuments": [
      {
        "thingName": "MyDevice1",
        "classic": false,
        "namedShadows": [
          "MyShadowA",
          "MyShadowB"
        ]
      },
      {
        "thingName": "MyDevice2",
        "classic": true,
        "namedShadows": []
      }
    ]
  },
  "rateLimits": {       
    "maxOutboundSyncUpdatesPerSecond": 100,
    "maxTotalLocalRequestsRate": 200,
    "maxLocalRequestsPerSecondPerThing": 20
  },
  "shadowDocumentSizeLimitBytes": 8192
}
```

------

## File di registro locale
<a name="shadow-manager-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="shadow-manager-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  Versione  |  Modifiche  | 
| --- | --- | 
|  2.3.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.11  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.3.10  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.3.9  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.3.8  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.7  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.6  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.5  | Versione aggiornata per Greengrass nucleus versione 2.12.0. | 
|  2.3.4  |  <a name="changelog-shadow-manager-2.3.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.3.3  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.3.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.4  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.3  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.2.2  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.2.1  |  Versione aggiornata per Greengrass nucleus versione 2.7.0.  | 
|  2.2.0  |  <a name="changelog-shadow-manager-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.6  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.3  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.1  |  Versione aggiornata per Greengrass nucleus versione 2.3.0.  | 
|  2.0.0  |  Versione iniziale.  | 

# Amazon SNS
<a name="sns-component"></a>

Il componente Amazon SNS (`aws.greengrass.SNS`) pubblica messaggi su un argomento di Amazon Simple Notification Service (Amazon SNS). È possibile utilizzare questo componente per inviare eventi dai dispositivi core Greengrass a server Web, indirizzi e-mail e altri abbonati ai messaggi. Per ulteriori informazioni, consulta [Cos'è Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)? nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.

Per pubblicare su un argomento di Amazon SNS con questo componente, pubblica un messaggio sull'argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente sottoscrive l'argomento di pubblicazione/sottoscrizione `sns/message` [locale](ipc-publish-subscribe.md). È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

Nel componente personalizzato, potresti voler implementare la logica di filtraggio o formattazione per elaborare i messaggi da altre fonti prima di pubblicarli su questo componente. Ciò consente di centralizzare la logica di elaborazione dei messaggi su un singolo componente.

**Nota**  
Questo componente offre funzionalità simili al connettore Amazon SNS nella AWS IoT Greengrass versione 1. Per ulteriori informazioni, consulta [Amazon SNS Connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) nella *AWS IoT Greengrass V1* Developer Guide.

**Topics**
+ [Versioni](#sns-component-versions)
+ [Tipo](#sns-component-type)
+ [Sistema operativo](#sns-component-os-support)
+ [Requisiti](#sns-component-requirements)
+ [Dipendenze](#sns-component-dependencies)
+ [Configurazione](#sns-component-configuration)
+ [Dati di input](#sns-component-input-data)
+ [Dati di output](#sns-component-output-data)
+ [File di registro locale](#sns-component-log-file)
+ [Licenze](#sns-component-licenses)
+ [Changelog](#sns-component-changelog)

## Versioni
<a name="sns-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="sns-component-type"></a>

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a>componente è un componente Lambda () `aws.greengrass.lambda`. [Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.](lambda-launcher-component.md)

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="sns-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="sns-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Argomento Amazon SNS Per le istruzioni, consulta [Creazione di un argomento Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) nella *Guida per lo Sviluppatore di Amazon Simple Notification Service*.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire l'`sns:Publish`azione, come illustrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "sns:Publish"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:sns:us-east-1:123456789012:topic-name"
        ]
      }
    ]
  }
  ```

------

  È possibile sovrascrivere dinamicamente l'argomento predefinito nel payload del messaggio di input per questo componente. Se l'applicazione utilizza questa funzionalità, la policy IAM deve includere tutti gli argomenti di destinazione come risorse. Puoi concedere alle risorse un accesso granulare o condizionale (ad esempio, utilizzando uno schema di denominazione con il carattere jolly `*`).
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il [componente legacy del router di abbonamento](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "component:aws.greengrass.SNS",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-sns:version",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Sostituiscilo con quello Regione AWS che usi.
  + Sostituisci *version* con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass) e cerca la coppia chiave-valore della **funzione Lambda**. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di sottoscrizione legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).
+ Il componente Amazon SNS è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente Amazon SNS deve disporre di una connettività con `sns.region.amazonaws.com` l'endpoint VPC di. `com.amazonaws.us-east-1.sns`

### Endpoint e porte
<a name="sns-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `sns.region.amazonaws.com`  | 443 | Sì |  Pubblicare i messaggi su Amazon SNS.  | 

## Dipendenze
<a name="sns-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#sns-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.8 e 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2,0,0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Rigidi | 
| [Lanciatore Lambda](lambda-launcher-component.md) | >=1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="sns-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`DEFAULT_SNS_ARN`  
L'ARN dell'argomento predefinito di Amazon SNS in cui questo componente pubblica i messaggi. Puoi sovrascrivere l'argomento di destinazione con la `sns_topic_arn` proprietà nel payload del messaggio di input.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 512 MB (525.312 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente sottoscrive la sottoscrizione per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti MQTT AWS IoT Core o gli argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Si tratta di un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abbonarsi ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` for`type`, è possibile utilizzare i caratteri jolly MQTT (`+`e`#`) in questo argomento.

**Example Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}
```

## Dati di input
<a name="sns-component-input-data"></a>

Questo componente accetta messaggi sul seguente argomento e pubblica il messaggio così com'è nell'argomento Amazon SNS di destinazione. <a name="connector-component-local-publish"></a>Per impostazione predefinita, questo componente sottoscrive i messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md). 

**Argomento predefinito (pubblicazione/sottoscrizione locale):** `sns/message`

<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.

`request`  
Le informazioni sul messaggio da inviare all'argomento Amazon SNS.  
Tipo: `object` che contiene le seguenti informazioni:    
`message`  
Il contenuto del messaggio sotto forma di stringa.  
Per inviare un oggetto JSON, serializzatelo come stringa e specificate `json` la `message_structure` proprietà.  
Tipo: `string`  
`subject`  
(Facoltativo) L'oggetto del messaggio.  
Tipo: `string`  
L'oggetto può essere testo ASCII e contenere fino a 100 caratteri. Deve iniziare con una lettera, un numero o un segno di punteggiatura. Non può includere interruzioni di riga o caratteri di controllo.  
`sns_topic_arn`  
(Facoltativo) L'ARN dell'argomento Amazon SNS in cui questo componente pubblica il messaggio. Specificare questa proprietà per sovrascrivere l'argomento predefinito di Amazon SNS.  
Tipo: `string`  
`message_structure`  
(Facoltativo) La struttura del messaggio. Specificate di `json` inviare un messaggio JSON da serializzare come stringa nella `content` proprietà.  
Tipo: `string`  
Valori validi: `json`

`id`  <a name="connector-component-input-property-id"></a>
Un ID arbitrario della richiesta. Utilizzate questa proprietà per mappare una richiesta di input a una risposta di output. Quando specificate questa proprietà, il componente imposta la `id` proprietà nell'oggetto di risposta su questo valore.  
Tipo: `string`

**Nota**  
La dimensione del messaggio può essere al massimo di 256 KB.

**Example Input di esempio: messaggio in formato stringa**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
  },
  "id": "request123"
}
```

**Example Input di esempio: messaggio JSON**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}
```

## Dati di output
<a name="sns-component-output-data"></a>

 <a name="connector-component-output-data"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come contenuto `subject` nella configurazione del componente [legacy del router di abbonamento](legacy-subscription-router-component.md). Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consulta[AWS IoT Core Pubblicare/sottoscrivere messaggi MQTT](ipc-iot-core-mqtt.md). 

**Argomento predefinito (AWS IoT Core MQTT):** `sns/message/status`

**Example Output di esempio: Operazione riuscita**  

```
{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}
```

**Example Esempio di output: Errore**  

```
{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}
```

## File di registro locale
<a name="sns-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.SNS.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SNS.log
  ```

## Licenze
<a name="sns-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:<a name="boto-3-licenses"></a>
+ [AWS SDK per Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="sns-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.10  | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
|  2.1.9  | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
|  2.1.8  | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
|  2.1.7  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  2.1.6  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.5  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.4  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.1.3  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.2  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.1.1  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/sns-component.html)  | 
|  2.0.8  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.6  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.5  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.4  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.3  |  Versione iniziale.  | 

# Stream manager
<a name="stream-manager-component"></a>

Il componente stream manager (`aws.greengrass.StreamManager`) consente di elaborare flussi di dati da trasferire Cloud AWS dai dispositivi core Greengrass.

Per ulteriori informazioni su come configurare e utilizzare stream manager nei componenti personalizzati, vedere. [Gestisci i flussi di dati sui dispositivi core Greengrass](manage-data-streams.md)

**Topics**
+ [Versioni](#stream-manager-component-versions)
+ [Tipo](#stream-manager-component-type)
+ [Sistema operativo](#stream-manager-component-os-support)
+ [Requisiti](#stream-manager-component-requirements)
+ [Dipendenze](#stream-manager-component-dependencies)
+ [Configurazione](#stream-manager-component-configuration)
+ [File di registro locale](#stream-manager-component-log-file)
+ [Changelog](#stream-manager-component-changelog)

## Versioni
<a name="stream-manager-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.2.x
+ 2.1.x
+ 2,0x

**Nota**  <a name="stream-manager-upgrade-note"></a>
Se utilizzi stream manager per esportare dati nel cloud, non puoi aggiornare la versione 2.0.7 del componente stream manager a una versione compresa tra v2.0.8 e v2.0.11. Se stai implementando stream manager per la prima volta, ti consigliamo vivamente di distribuire la versione più recente del componente stream manager.

## Tipo
<a name="stream-manager-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="stream-manager-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="stream-manager-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il [ruolo di scambio di token](device-service-role.md) deve consentire l'accesso alle Cloud AWS destinazioni utilizzate con stream manager. Per ulteriori informazioni, consulta:<a name="export-destinations-links"></a>
  + [AWS IoT Analytics canali](stream-export-configurations.md#export-to-iot-analytics)
  + [Flussi di dati Amazon Kinesis](stream-export-configurations.md#export-to-kinesis)
  + [AWS IoT SiteWise proprietà degli asset](stream-export-configurations.md#export-to-iot-sitewise)
  + [Oggetti Amazon S3](stream-export-configurations.md#export-to-s3)
+ Il componente stream manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente stream manager deve essere connesso al AWS servizio su cui si pubblicano i dati.
    + Amazon S3: `com.amazonaws.region.s3`
    + Amazon Kinesis Data Streams: `com.amazonaws.region.kinesis-streams`
    + AWS IoT SiteWise: `com.amazonaws.region.iotsitewise.data`
  + Se pubblichi dati su Amazon S3 nella `us-east-1` regione, questo componente tenterà di utilizzare l'endpoint globale S3 per impostazione predefinita; tuttavia, questo endpoint non è disponibile tramite l'endpoint dell'interfaccia VPC di Amazon S3. Per ulteriori informazioni, consulta [Restrizioni e limitazioni AWS PrivateLink di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/privatelink-interface-endpoints.html#privatelink-limitations). Per risolvere questo problema, puoi scegliere tra le seguenti opzioni.
    + Configura il componente stream manager per utilizzare l'endpoint S3 regionale nella `us-east-1` regione, `-Daws.s3UseUsEast1RegionalEndpoint=regional` configurando in. `JVM_ARGS`
    + Crea un endpoint VPC gateway Amazon S3 anziché un endpoint VPC con interfaccia Amazon S3. Gli endpoint gateway S3 supportano l'accesso all'endpoint globale S3. Per ulteriori informazioni, consulta [Creare](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3) un endpoint gateway.

### Endpoint e porte
<a name="stream-manager-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `iotanalytics.region.amazonaws.com`  | 443 | No |  Obbligatorio se si pubblicano dati su. AWS IoT Analytics  | 
|  `kinesis.region.amazonaws.com`  | 443 | No |  Obbligatorio se si pubblicano dati su Firehose.  | 
|  `data.iotsitewise.region.amazonaws.com`  | 443 | No |  Obbligatorio se si pubblicano dati su. AWS IoT SiteWise  | 
|  `*.s3.amazonaws.com`  | 443 | No |  Obbligatorio se pubblichi dati su bucket S3. Puoi sostituirlo `*` con il nome di ogni bucket in cui pubblichi i dati.  | 

## Dipendenze
<a name="stream-manager-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#stream-manager-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.3 – 2.2.1 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.3 a 2.2.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <3.0.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.11 – 2.1.12 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.11 a 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.13.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.9 – 2.1.10 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.9 a 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.12.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.5 – 2.1.8 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.5 a 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.11.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.2 – 2.1.4 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.2 a 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.10.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.9.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.8.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.15 ]

La tabella seguente elenca le dipendenze per la versione 2.0.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.7.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.13 and 2.0.14 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.13 e 2.0.14 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.6.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.11 and 2.0.12 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.11 e 2.0.12 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.5.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.10 ]

La tabella seguente elenca le dipendenze per la versione 2.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.4.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.9 ]

La tabella seguente elenca le dipendenze per la versione 2.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.3.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.8 ]

La tabella seguente elenca le dipendenze per la versione 2.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.2.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=0.0.0  | Rigidi | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="stream-manager-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`STREAM_MANAGER_STORE_ROOT_DIR`  
(Facoltativo) Il percorso assoluto della directory locale utilizzata per archiviare gli stream. Questo valore deve iniziare con una barra (ad esempio, `/data`).  
<a name="stream-manager-store-root-dir-parameter-folder-requirements"></a>È necessario specificare una cartella esistente e l'[utente di sistema che esegue il componente stream manager](configure-greengrass-core-v2.md#configure-component-user) deve disporre delle autorizzazioni per leggere e scrivere in questa cartella. Ad esempio, è possibile eseguire i seguenti comandi per creare e configurare una cartella`/var/greengrass/streams`, specificata come cartella principale dello stream manager. Questi comandi consentono all'utente di sistema predefinito di leggere e scrivere in questa cartella. `ggc_user`  

```
sudo mkdir /var/greengrass/streams
sudo chown ggc_user /var/greengrass/streams
sudo chmod 700 /var/greengrass/streams
```
Impostazione predefinita: `/greengrass/v2/work/aws.greengrass.StreamManager`

`STREAM_MANAGER_SERVER_PORT`  
(Facoltativo) Il numero di porta locale da utilizzare per comunicare con lo stream manager.  
È possibile specificare `0` di utilizzare una porta disponibile in modo casuale.  
Impostazione predefinita: `8088`

`STREAM_MANAGER_AUTHENTICATE_CLIENT`  
(Facoltativo) Puoi rendere obbligatoria l'autenticazione dei client prima che possano interagire con lo stream manager. L'SDK Stream Manager controlla l'interazione tra i client e lo stream manager. Questo parametro determina quali client possono chiamare l'SDK di Stream Manager per lavorare con gli stream. Per ulteriori informazioni, consulta [Stream Manager Client](manage-data-streams.md#stream-manager-security-client-authentication) Authentication.  
Se si specifica`true`, Stream Manager SDK consente solo i componenti Greengrass come client.  
Se lo specifichi`false`, Stream Manager SDK consente a tutti i processi sul dispositivo principale di essere client.  
Impostazione predefinita: `true`

`STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH`  
(Facoltativo) La larghezza di banda massima media (in kilobit al secondo) che lo stream manager può utilizzare per esportare i dati.  
Impostazione predefinita: nessun limite

`STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE`  
(Facoltativo) Il numero massimo di thread attivi che lo stream manager può utilizzare per esportare i dati.  
La dimensione ottimale dipende dall'hardware, dal volume del flusso e dal numero pianificato di flussi di esportazione. Se la velocità di esportazione è bassa, puoi regolare questa impostazione per trovare la dimensione ottimale per l'hardware e il business case. La CPU e la memoria dell'hardware del dispositivo core sono fattori limitanti. Per iniziare, è possibile provare a impostare questo valore uguale al numero di core di processore sul dispositivo.  
Fare attenzione a non impostare una dimensione superiore a quella supportata dall'hardware. Ogni stream consuma risorse hardware, quindi cercate di limitare il numero di flussi di esportazione su dispositivi con restrizioni.  
Impostazione predefinita: 5 thread

`STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES`  
(Facoltativo) La dimensione minima (in byte) di una parte in un caricamento multiparte su Amazon S3. Stream Manager utilizza questa impostazione e la dimensione del file di input per determinare come raggruppare i dati in una richiesta PUT composta da più parti.  
Stream Manager utilizza la `sizeThresholdForMultipartUploadBytes` proprietà streams per determinare se esportare in Amazon S3 come caricamento singolo o multiparte. AWS IoT Greengrass i componenti possono impostare questa soglia quando creano uno stream che esporta in Amazon S3.
Impostazione predefinita: `5242880` (5 MB). Questo è anche il valore minimo.

`LOG_LEVEL`  
(Facoltativo) Il livello di registrazione per il componente. Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  
+ `TRACE`
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Impostazione predefinita: `INFO`

`JVM_ARGS`  
(Facoltativo) Gli argomenti personalizzati della Java Virtual Machine da passare allo stream manager all'avvio. Separa più argomenti per spazi.  
Utilizza questo parametro solo quando devi sostituire le impostazioni predefinite utilizzate dalla JVM. Ad esempio, potrebbe essere necessario aumentare la dimensione heap predefinita se prevedi di esportare un numero elevato di flussi.

`startupTimeoutSeconds`  
(Facoltativo) Il tempo massimo, in secondi, di avvio del componente. Lo stato del componente cambia `ERRORED` se supera questo timeout.  
Impostazione predefinita: `120`

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica l'utilizzo di una porta non predefinita.  

```
{
  "STREAM_MANAGER_SERVER_PORT": "18088"
}
```

## File di registro locale
<a name="stream-manager-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.greengrass.StreamManager.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.greengrass.StreamManager.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.StreamManager.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="stream-manager-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.2.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.2.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.11  | Versione aggiornata per Greengrass nucleus versione 2.12.0. | 
|  2.1.10  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.9  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  2.1.8  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.7  |  <a name="changelog-stream-manager-2.1.7"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.6  |  <a name="changelog-stream-manager-2.1.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.5  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  2.1.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.1  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.0.15  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  2.0.14  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  2.0.13  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
| 2.0.12 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.0.11  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  2.0.10  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.0.9  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.0.8  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.7  |  Versione iniziale.  | 

# Inoltro di log di sistema
<a name="system-log-forwarder-component"></a>

Il System log forwarder (`aws.greengrass.SystemLogForwarder`) carica i log di sistema attivi direttamente su Amazon CloudWatch utilizzando l'API HTTPS. CloudWatch 

**Importante**  
Questo componente inoltrerà solo i log systemd-journald generati durante l'esecuzione. [https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html)

**Nota**  
Questo componente richiede autorizzazioni specifiche per creare e gestire gruppi e flussi di log. CloudWatch 

**Topics**
+ [Versioni](#system-log-forwarder-component-versions)
+ [Tipo](#system-log-forwarder-component-type)
+ [Sistema operativo](#system-log-forwarder-component-os-support)
+ [Requisiti](#system-log-forwarder-component-requirements)
+ [Endpoint e porte](#system-log-forwarder-component-endpoints)
+ [Dipendenze](#system-log-forwarder-component-dependencies)
+ [Configurazione](#system-log-forwarder-component-configuration)
+ [Changelog](#system-log-forwarder-component-changelog)

## Versioni
<a name="system-log-forwarder-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="system-log-forwarder-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico (`aws.greengrass.generic`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="system-log-forwarder-component-os-support"></a>

Questo componente deve essere installato su sistemi Linux basati su sistema.

## Requisiti
<a name="system-log-forwarder-component-requirements"></a>

Questo componente presenta i seguenti requisiti:

Il componente richiede l'accesso per creare gruppi di log e stream, CloudWatch nonché l'autorizzazione per eseguire la chiamata PutLogEvents HTTP. È necessario aggiungere almeno le seguenti autorizzazioni di policy all'alias di ruolo del dispositivo Greengrass:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogGroup"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
    },
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
    }
  ]
}
```

------

**Nota**  
[Per ulteriori informazioni, consulta la pagina Github di System Log Forwarder.](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder)

## Endpoint e porte
<a name="system-log-forwarder-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | No |  Obbligatorio se si scrivono log in Logs. CloudWatch   | 

## Dipendenze
<a name="system-log-forwarder-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#system-log-forwarder-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.1.x ]

La tabella seguente elenca le dipendenze per la versione 2.1.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.0 | Rigidi | 
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | >=2.3.0 | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.0 | Rigidi | 

------

## Configurazione
<a name="system-log-forwarder-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.0.x-2.1.x ]

`maxUploadIntervalSec`  
Il periodo massimo in cui il log forwarder di sistema tenterà di caricare i log. Poiché il log forwarder caricherà i log quando la memoria si riempie, potrebbe comunque caricarsi più spesso della cadenza massima configurata.

`maxRetriesCount`  
Numero di volte in cui il log forwarder di sistema tenterà di riprovare un errore HTTP transitorio.

`bufferCapacity`  
La dimensione del ring buffer per l'archiviazione dei log in memoria.

`logGroup`  
Il percorso del registro in. CloudWatch

`logStream`  
Il CloudWatch LogStream.

`filters`  
Una mappa delle configurazioni dei filtri per il dispositivo principale.    
`services`  
Un elenco di filtri per i nomi di servizio che System Log Forwarder utilizzerà per determinare quali log verranno caricati. Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco. I filtri in questo elenco possono essere una stringa a cui il nome del servizio deve corrispondere completamente o una stringa che termina con \$1, il che significa che il prefisso deve corrispondere.  
Impostazione predefinita: `[ggl.*]`  
Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco.
L'utilizzo del valore \$1 includerà tutti i servizi disponibili.

**Example Configurazione di esempio:**  
L'esempio seguente filtrerà i log in base a tutti i servizi inclusi in Greengrass Nucleus Lite.  

```
{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}
```

------

## Changelog
<a name="system-log-forwarder-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Versione iniziale.  | 

# Agente Systems Manager
<a name="systems-manager-agent-component"></a>

Il componente AWS Systems Manager Agent (`aws.greengrass.SystemsManagerAgent`) installa Systems Manager Agent, in modo da poter gestire i dispositivi principali con Systems Manager. Systems Manager è un AWS servizio che puoi utilizzare per visualizzare e controllare la tua infrastruttura AWS, tra cui EC2 istanze Amazon, server e macchine virtuali locali (VMs) e dispositivi periferici. Systems Manager consente di visualizzare i dati operativi, automatizzare le attività operative e mantenere la sicurezza e la conformità. Per ulteriori informazioni, vedere [Cos'è AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) e [Informazioni su Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) nella *Guida AWS Systems Manager per l'utente*.

<a name="about-systems-manager-capabilities"></a>Gli strumenti e le funzionalità di Systems Manager sono denominati *funzionalità*. I dispositivi core Greengrass supportano tutte le funzionalità di Systems Manager. Per ulteriori informazioni su queste funzionalità e su come utilizzare Systems Manager per gestire i dispositivi principali, vedere [le funzionalità di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) nella *Guida per l'AWS Systems Manager utente*.

**Topics**
+ [Versioni](#systems-manager-agent-component-versions)
+ [Tipo](#systems-manager-agent-component-type)
+ [Sistema operativo](#systems-manager-agent-component-os-support)
+ [Requisiti](#systems-manager-agent-component-requirements)
+ [Dipendenze](#systems-manager-agent-component-dependencies)
+ [Configurazione](#systems-manager-agent-component-configuration)
+ [File di registro locale](#systems-manager-agent-component-log-file)
+ [Consulta anche](#systems-manager-agent-component-see-also)
+ [Changelog](#systems-manager-agent-component-changelog)

## Versioni
<a name="systems-manager-agent-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Tipo
<a name="systems-manager-agent-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="systems-manager-agent-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

## Requisiti
<a name="systems-manager-agent-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ Un dispositivo core Greengrass che funziona su una piattaforma Linux a 64 bit: Armv8 () AArch64 o x86\$164.
+ È necessario disporre di un ruolo di servizio AWS Identity and Access Management (IAM) che Systems Manager possa assumere. Questo ruolo deve includere la politica SSMManaged InstanceCore gestita da [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una politica personalizzata che definisca autorizzazioni equivalenti. Per ulteriori informazioni, consulta [Create an IAM service role for edge devices](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) nella *Guida per l'AWS Systems Manager utente*.

  Quando distribuisci questo componente, devi specificare il nome di questo ruolo per il parametro di `SSMRegistrationRole` configurazione.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire le azioni `ssm:AddTagsToResource` e`ssm:RegisterManagedInstance`. Il ruolo del dispositivo deve inoltre consentire l'`iam:PassRole`azione del ruolo del servizio IAM che soddisfa il requisito precedente. Il seguente esempio di policy IAM concede queste autorizzazioni.

  ```
  {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "iam:PassRole"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:iam::account-id:role/SSMServiceRole"
        ]
      },
      {
        "Action": [
          "ssm:AddTagsToResource",
          "ssm:RegisterManagedInstance"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

### Endpoint e porte
<a name="systems-manager-agent-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `ec2messages.region.amazonaws.com`  | 443 | Sì |  Comunica con il servizio Systems Manager in Cloud AWS.  | 
|  `ssm.region.amazonaws.com`  | 443 | Sì |  Registrare il dispositivo principale come nodo gestito da Systems Manager.  | 
|  `ssmmessages.region.amazonaws.com`  | 443 | Sì |  Comunica con Session Manager, una funzionalità di Systems Manager, in Cloud AWS.  | 

*Per ulteriori informazioni, consulta [Riferimento: ec2messages, ssmmessages e altre chiamate API](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html) nella Guida per l'utente.AWS Systems Manager *

## Dipendenze
<a name="systems-manager-agent-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#systems-manager-agent-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per le versioni da 1.0.0 a 1.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=2.0.0 <3.0.0 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="systems-manager-agent-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`SSMRegistrationRole`  
Il ruolo del servizio IAM che Systems Manager può assumere e che include la policy SSMManaged InstanceCore gestita da [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una policy personalizzata che definisce autorizzazioni equivalenti. Per ulteriori informazioni, consulta [Creare un ruolo di servizio IAM per i dispositivi edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) nella *Guida per l'AWS Systems Manager utente*.

`SSMOverrideExistingRegistration`  
(Facoltativo) Se il dispositivo principale esegue già il Systems Manager Agent registrato con un'attivazione ibrida, è possibile sovrascrivere la registrazione Systems Manager Agent esistente del dispositivo. Imposta questa opzione `true` per registrare il dispositivo principale come nodo gestito utilizzando l'agente Systems Manager fornito da questo componente.  
Questa opzione si applica solo ai dispositivi registrati con un'attivazione ibrida. Se il dispositivo principale viene eseguito su un' EC2 istanza Amazon con Systems Manager Agent installato e un ruolo del profilo dell'istanza configurato, l'ID del nodo gestito esistente dell' EC2 istanza Amazon inizia con`i-`. Quando si installa il componente Systems Manager Agent, l'agente Systems Manager registra un nuovo nodo gestito il cui ID inizia con `mi-` invece di`i-`. Quindi, è possibile utilizzare il nodo gestito il cui ID inizia con `mi-` per gestire il dispositivo principale con Systems Manager.
Impostazione predefinita: `false`

`SSMResourceTags`  
(Facoltativo) I tag da aggiungere al nodo gestito di Systems Manager che questo componente crea per il dispositivo principale. È possibile utilizzare questi tag per gestire gruppi di dispositivi principali con Systems Manager. Ad esempio, è possibile eseguire un comando su tutti i dispositivi che dispongono di un tag specificato dall'utente.  
Specificate un elenco in cui ogni tag è un oggetto con un `Key` e un`Value`. Ad esempio, il seguente valore di `SSMResourceTags` indica a questo componente di impostare il **Owner** tag **richard-roe** sul nodo gestito del dispositivo principale.  

```
[
  {
    "Key": "Owner",
    "Value": "richard-roe"
  }
]
```
Questo componente ignora questi tag se il nodo gestito esiste già e `SSMOverrideExistingRegistration` lo è. `false`

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica l'utilizzo di un ruolo di servizio denominato `SSMServiceRole` per consentire al dispositivo principale di registrarsi e comunicare con Systems Manager.  

```
{
  "SSMRegistrationRole": "SSMServiceRole",
  "SSMOverrideExistingRegistration": false,
  "SSMResourceTags": [
    {
      "Key": "Owner",
      "Value": "richard-roe"
    },
    {
      "Key": "Team",
      "Value": "solar"
    }
  ]
}
```

## File di registro locale
<a name="systems-manager-agent-component-log-file"></a>

Il software Systems Manager Agent scrive i log in una cartella esterna alla cartella principale di Greengrass. Per ulteriori informazioni, vedere [Visualizzazione dei log di Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) nella *Guida per l'AWS Systems Manager utente*.

Il componente Systems Manager Agent utilizza script di shell per installare, avviare e arrestare Systems Manager Agent. È possibile trovare l'output di questi script nel seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
  ```

## Consulta anche
<a name="systems-manager-agent-component-see-also"></a>
+ [Gestisci i dispositivi core Greengrass con AWS Systems Manager](manage-with-systems-manager.md)
+ [Cos'è AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) nella *Guida per l'utente di AWS Systems Manager *
+ [Informazioni su Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) nella *Guida AWS Systems Manager per l'utente*

## Changelog
<a name="systems-manager-agent-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.1.0  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  1.0.0  |  Versione iniziale.  | 

# Servizio di scambio di token
<a name="token-exchange-service-component"></a>

Il componente del servizio di scambio di token (`aws.greengrass.TokenExchangeService`) fornisce AWS credenziali che è possibile utilizzare per interagire con AWS i servizi dei componenti personalizzati.

Il servizio di scambio di token funziona come server locale. Questo server locale si connette al provider di AWS IoT credenziali utilizzando l'alias del AWS IoT ruolo configurato nel componente core nucleus di [Greengrass](greengrass-nucleus-component.md). Il componente fornisce due variabili di ambiente e. `AWS_CONTAINER_CREDENTIALS_FULL_URI` `AWS_CONTAINER_AUTHORIZATION_TOKEN` `AWS_CONTAINER_CREDENTIALS_FULL_URI`definisce l'URI di questo server locale. Quando un componente crea un client AWS SDK, il client riconosce questa variabile di ambiente URI e utilizza il token in `AWS_CONTAINER_AUTHORIZATION_TOKEN` per connettersi al servizio di scambio di token e recuperare AWS le credenziali. Ciò consente ai dispositivi core Greengrass di chiamare le operazioni di AWS assistenza. Per ulteriori informazioni su come utilizzare questo componente nei componenti personalizzati, vedere[Interagisci con AWS i servizi](interact-with-aws-services.md).

**Importante**  <a name="token-exchange-service-aws-sdk-requirement"></a>
Il supporto per l'acquisizione di AWS credenziali in questo modo è stato aggiunto il 13 AWS SDKs luglio 2016. Il componente deve utilizzare una versione AWS SDK creata a partire da tale data. Per ulteriori informazioni, consulta [Using a support AWS SDK](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html#task-iam-roles-minimum-sdk) nella *Amazon Elastic Container Service Developer Guide*.

**Nota**  
I componenti che utilizzano la catena di credenziali AWS predefinita possono scoprire e utilizzare altre fonti di credenziali, se esistenti. All'interno del container Amazon Elastic Container Service (Amazon ECS), `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` le credenziali del contenitore Amazon Elastic Container Service (Amazon ECS) avranno la precedenza`AWS_CONTAINER_CREDENTIALS_FULL_URI`, il che significa che le credenziali del servizio di scambio di token potrebbero non funzionare all'interno di Amazon Elastic Container Service (Amazon ECS). [Per ulteriori informazioni, consulta i fornitori di credenziali standardizzati](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) 

**Topics**
+ [Versioni](#token-exchange-service-component-versions)
+ [Tipo](#token-exchange-service-component-type)
+ [Sistema operativo](#token-exchange-service-component-os-support)
+ [Dipendenze](#token-exchange-service-component-dependencies)
+ [Configurazione](#token-exchange-service-component-configuration)
+ [File di registro locale](#token-exchange-service-component-log-file)
+ [Changelog](#token-exchange-service-component-changelog)

## Versioni
<a name="token-exchange-service-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.0.x

## Tipo
<a name="token-exchange-service-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico (`aws.greengrass.generic`). Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="token-exchange-service-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Dipendenze
<a name="token-exchange-service-component-dependencies"></a>

Questo componente non ha alcuna dipendenza.

## Configurazione
<a name="token-exchange-service-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare quando si distribuisce il componente.

`port`  
La porta da utilizzare per le connessioni al servizio di scambio di token. Il servizio di scambio di token verrà riavviato dopo le modifiche alla configurazione delle porte.

`credentialRetryInSec`  
Speciifica gli intervalli di tentativi in secondi quando il servizio Token Exchange rileva errori di richiesta di credenziali.    
`clientError`  
L'intervallo di tentativi in secondi per gli errori del client (4xx codici di stato HTTP).  
Default: `120`  
Valori validi: da `10` a `42900`  
`serverError`  
L'intervallo di tentativi in secondi per gli errori del server (5xx codici di stato HTTP).  
Default: `60`  
Valori validi: da `10` a `42900`  
`unknownError`  
L'intervallo di tentativi in secondi per errori sconosciuti (errori di connessione e codici di stato HTTP al di fuori degli intervalli 4xx e 5xx).  
Default: `300`  
Valori validi: da `10` a `42900`

**Example Esempio: fusione e aggiornamento della configurazione**  

```
{
   "port": 2020,
   "credentialRetryInSec": {
    "clientError": 30,
    "serverError": 45,
    "unknownError": 60
   }
}
```

## File di registro locale
<a name="token-exchange-service-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="token-exchange-service-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.0.3  |  Versione iniziale.  | 

# Collettore IoT SiteWise OPC UA
<a name="iotsitewise-opcua-collector-component"></a>

Il componente IoT SiteWise OPC UA collector (`aws.iot.SiteWiseEdgeCollectorOpcua`) consente ai AWS IoT SiteWise gateway di raccogliere dati dai server OPC UA locali.

Con questo componente, i AWS IoT SiteWise gateway possono connettersi a più server OPC UA. *Per ulteriori informazioni sui AWS IoT SiteWise gateway, consulta [Using AWS IoT SiteWise at the edge](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) nella Guida per l'AWS IoT SiteWise utente.*

**Topics**
+ [Versioni](#iotsitewise-opcua-collector-component-versions)
+ [Tipo](#iotsitewise-opcua-collector-component-type)
+ [Sistema operativo](#iotsitewise-opcua-collector-component-os-support)
+ [Requisiti](#iotsitewise-opcua-collector-component-requirements)
+ [Dipendenze](#iotsitewise-opcua-collector-component-dependencies)
+ [Configurazione](#iotsitewise-opcua-collector-component-configuration)
+ [Dati di input](#iotsitewise-opcua-collector-component-input-data)
+ [Dati di output](#iotsitewise-opcua-collector-component-output-data)
+ [File di registro locale](#iotsitewise-opcua-collector-component-log-file)
+ [Licenze](#iotsitewise-opcua-collector-component-licenses)
+ [Changelog](#iotsitewise-opcua-collector-component-changelog)
+ [Consulta anche](#iotsitewise-opcua-collector-component-see-also)

## Versioni
<a name="iotsitewise-opcua-collector-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 3.1.x
+ 3.0.x
+ 2.6.x
+ 2,5. x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2,0x

## Tipo
<a name="iotsitewise-opcua-collector-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-opcua-collector-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="iotsitewise-opcua-collector-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale Greengrass deve funzionare su una delle seguenti piattaforme:
  + sistema operativo: Ubuntu 20.04 o successivo

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + Sistema operativo: Red Hat Enterprise Linux (RHEL) 8

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + Sistema operativo: Amazon Linux 2

    architettura: x86\$164 (AMD64) o ARMv8 (Aarch64)
  + Sistema operativo: Debian 11

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + sistema operativo: Windows Server 2019 o successivo

    architettura: x86\$164 () AMD64
+ Il dispositivo principale Greengrass deve consentire la connettività di rete in uscita ai server OPC UA.

## Dipendenze
<a name="iotsitewise-opcua-collector-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#iotsitewise-opcua-collector-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per tutte le versioni di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Rigidi | 
| [Stream manager](stream-manager-component.md) | >=2.3.0 2,0,10<3,0,0 | Rigidi | 
| [Gestore segreto](secret-manager-component.md) | >2,0,10 =2,0,8 <3,0,0 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="iotsitewise-opcua-collector-component-configuration"></a>

Questo componente non ha parametri di configurazione.

Puoi utilizzare la AWS IoT SiteWise console o l'API per configurare il componente IoT SiteWise OPC UA Collector. Per ulteriori informazioni, consulta [Fase 4: Aggiungere fonti di dati, facoltativa nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console) per l'*AWS IoT SiteWise utente*.

## Dati di input
<a name="iotsitewise-opcua-collector-component-input-data"></a>

Questo componente accetta solo dati nei seguenti formati, tutti gli altri verranno ignorati e scartati. La tabella seguente associa i tipi di dati OPC UA ai loro equivalenti. SiteWise 


|  **SiteWise tipo di dati**  |  **Tipo di dati OPC UA**  |  **Descrizione**  | 
| --- | --- | --- | 
|  `STRING`  |  `String` `Guid` `XmlElement`  |  Una stringa di lunghezza massima di 1024 byte.  | 
|  `INTEGER`  |  `SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`\$1 `Int64`\$1  |  Un numero intero con segno a 32 bit con un intervallo da. `-2,147,483,648 to 2,147,483,647`  | 
|  `DOUBLE`  |  `UInt32`\$1 `Int64`\$1 `Float` `Double`  |  Un numero a virgola mobile con intervallo `–10^100 to 10^100` e `IEEE 754` precisione doppia.  | 
|  `BOOLEAN`  |  `Boolean`  |  `true` o `false`.  | 

\$1 Per i tipi di dati OPC UA `UInt32` e`Int64`, il suo tipo di SiteWise dati sarà `INTEGER` se SiteWise è in grado di rappresentarne il valore, altrimenti lo sarà. `DOUBLE`

## Dati di output
<a name="iotsitewise-opcua-collector-component-output-data"></a>



Questo componente scrive `BatchPutAssetPropertyValue` messaggi nello AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) nella *documentazione di riferimento dell'API AWS IoT SiteWise *.

## File di registro locale
<a name="iotsitewise-opcua-collector-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
  ```

------

## Licenze
<a name="iotsitewise-opcua-collector-component-licenses"></a>

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="iotsitewise-opcua-collector-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.4.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.4.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.4.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.0.3  |  Correzioni di bug e miglioramenti.  | 
|  2.0.2  |  Correzioni di bug e miglioramenti alla sincronizzazione delle priorità delle risorse con Edge.  | 
|  2.0.1  |  Versione iniziale.  | 

## Consulta anche
<a name="iotsitewise-opcua-collector-component-see-also"></a>
+ [Che cos'è? AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) nella *Guida AWS IoT SiteWise per l'utente*.

# Simulatore di sorgenti dati IoT SiteWise OPC UA
<a name="iotsitewise-opcua-data-source-simulator-component"></a>

Il componente IoT SiteWise OPC UA Data Source Simulator (`aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator`) avvia un server OPC UA locale che genera dati di esempio. Usa questo server OPC UA per simulare una fonte di dati letta dal [componente IoT SiteWise OPC UA Collector](iotsitewise-opcua-collector-component.md) su un gateway. AWS IoT SiteWise Quindi, puoi esplorare le AWS IoT SiteWise funzionalità utilizzando questi dati di esempio. Per ulteriori informazioni sui AWS IoT SiteWise gateway, consulta [Using AWS IoT SiteWise at the edge](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) nella *Guida per l'AWS IoT SiteWise utente*.

**Topics**
+ [Versioni](#iotsitewise-opcua-data-source-simulator-component-versions)
+ [Tipo](#iotsitewise-opcua-data-source-simulator-component-type)
+ [Sistema operativo](#iotsitewise-opcua-data-source-simulator-component-os-support)
+ [Requisiti](#iotsitewise-opcua-data-source-simulator-component-requirements)
+ [Dipendenze](#iotsitewise-opcua-data-source-simulator-component-dependencies)
+ [Configurazione](#iotsitewise-opcua-data-source-simulator-component-configuration)
+ [File di registro locale](#iotsitewise-opcua-data-source-simulator-component-log-file)
+ [Changelog](#iotsitewise-opcua-data-source-simulator-component-changelog)
+ [Consulta anche](#iotsitewise-opcua-data-source-simulator-component-see-also)

## Versioni
<a name="iotsitewise-opcua-data-source-simulator-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.0.x

## Tipo
<a name="iotsitewise-opcua-data-source-simulator-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-opcua-data-source-simulator-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="iotsitewise-opcua-data-source-simulator-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale Greengrass deve essere in grado di utilizzare la porta 4840 sull'host locale. Il server OPC UA locale di questo componente funziona su questa porta.

## Dipendenze
<a name="iotsitewise-opcua-data-source-simulator-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#iotsitewise-opcua-data-source-simulator-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per tutte le versioni di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="iotsitewise-opcua-data-source-simulator-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="iotsitewise-opcua-data-source-simulator-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="iotsitewise-opcua-data-source-simulator-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.0.0  |  Versione iniziale. Aggiunge il supporto per Windows Server 2016 o versioni successive.  | 

## Consulta anche
<a name="iotsitewise-opcua-data-source-simulator-component-see-also"></a>
+ [Che cos'è AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) nella *Guida AWS IoT SiteWise per l'utente*.

# SiteWise Editore IoT
<a name="iotsitewise-publisher-component"></a>

Il componente IoT SiteWise Publisher (`aws.iot.SiteWiseEdgePublisher`) consente ai AWS IoT SiteWise gateway di esportare dati dall'edge al Cloud AWS.

Per ulteriori informazioni sui AWS IoT SiteWise gateway, vedere [Using AWS IoT SiteWise at the edge nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) per l'*AWS IoT SiteWise utente*.

**Topics**
+ [Versioni](#iotsitewise-publisher-component-versions)
+ [Tipo](#iotsitewise-publisher-component-type)
+ [Sistema operativo](#iotsitewise-publisher-component-os-support)
+ [Requisiti](#iotsitewise-publisher-component-requirements)
+ [Dipendenze](#iotsitewise-publisher-component-dependencies)
+ [Configurazione](#iotsitewise-publisher-component-configuration)
+ [Dati di input](#iotsitewise-publisher-component-input-data)
+ [File di registro locale](#iotsitewise-publisher-component-log-file)
+ [Risoluzione dei problemi e debug](#iotsitewise-publisher-component-debug)
+ [Licenze](#iotsitewise-publisher-component-licenses)
+ [Changelog](#iotsitewise-publisher-component-changelog)
+ [Consulta anche](#iotsitewise-publisher-component-see-also)

## Versioni
<a name="iotsitewise-publisher-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 4.1.x
+ 4,0x
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="iotsitewise-publisher-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-publisher-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="iotsitewise-publisher-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale Greengrass deve funzionare su una delle seguenti piattaforme:
  + sistema operativo: Ubuntu 18.04 o successivo

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + Sistema operativo: Red Hat Enterprise Linux (RHEL) 8

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + Sistema operativo: Amazon Linux 2

    architettura: x86\$164 (AMD64) o ARMv8 (Aarch64)
  + Sistema operativo: Debian 11

    architettura: x86\$164 (AMD64) o (Aarch64) ARMv8 
  + sistema operativo: Windows Server 2019 o successivo

    architettura: x86\$164 () AMD64
+ Il dispositivo principale Greengrass deve connettersi a Internet.
+ Il dispositivo principale Greengrass deve essere autorizzato a eseguire l'azione`iotsitewise:BatchPutAssetPropertyValue`. Per ulteriori informazioni, consulta [Autorizzare i dispositivi principali a interagire con AWS](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) i servizi.  
**Example policy di autorizzazioni**  

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Effect": "Allow",
              "Action": "iotsitewise:BatchPutAssetPropertyValue",
              "Resource": "*"
          }
      ]
  }
  ```

------

### Endpoint e porte
<a name="iotsitewise-publisher-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `data.iotsitewise.region.amazonaws.com`  | 443 | Sì |  Pubblica dati su. AWS IoT SiteWise  | 

## Dipendenze
<a name="iotsitewise-publisher-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#iotsitewise-publisher-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per le versioni da 2.0.x a 2.2.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2,3,0<3,0,0 | Rigidi | 
| [Stream manager](stream-manager-component.md) | >=2.3.0 =2,010<3,00 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="iotsitewise-publisher-component-configuration"></a>

Questo componente non ha parametri di configurazione.

Puoi utilizzare la AWS IoT SiteWise console o l'API per configurare il componente SiteWise editore IoT. Per ulteriori informazioni, consulta [Fase 3: Configurazione dell'editore - opzionale](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#configure-publisher) nella *Guida AWS IoT SiteWise per l'utente*.

## Dati di input
<a name="iotsitewise-publisher-component-input-data"></a>



Questo componente legge i `PutAssetPropertyValueEntry` messaggi dallo AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta [PutAssetPropertyValueEntry](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html) nella *documentazione di riferimento dell’API AWS IoT SiteWise *.

## File di registro locale
<a name="iotsitewise-publisher-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait
  ```

------

## Risoluzione dei problemi e debug
<a name="iotsitewise-publisher-component-debug"></a>

Questo componente include un nuovo registro degli eventi per aiutare i clienti a identificare e risolvere i problemi. Il file di registro è separato dal file di registro locale e si trova nella seguente posizione. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

```
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log
```

------

Questo registro include informazioni dettagliate e istruzioni per la risoluzione dei problemi. Oltre alla diagnostica, vengono fornite informazioni sulla risoluzione dei problemi, con una descrizione di come risolvere il problema e, a volte, con collegamenti a ulteriori informazioni. Le informazioni diagnostiche includono quanto segue:
+ Livello di gravità
+ Time stamp
+ Informazioni aggiuntive specifiche sull'evento

**Example Log di esempio**  

```
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log
```

## Licenze
<a name="iotsitewise-publisher-component-licenses"></a>

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="iotsitewise-publisher-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 4.1.4 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
| 4.1.3 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
| 4.1.2 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
| 4.1.1 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
| 4.1.0 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  4.0.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  4.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  4.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  4.0.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.1.4  |   La versione 3.1.4 è stata interrotta il 20 febbraio 2025. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.1.1  |   La versione 3.1.1 è stata interrotta il 12 marzo 2024. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  3.0.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.4.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.4.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.3.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.3.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.3.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.2.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.2.1  |   Questa versione non supporta la configurazione del proxy HTTP. La versione 2.2.2 e successive reintroducono il supporto per questa funzionalità.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.2.0  |   Questa versione non supporta la configurazione del proxy HTTP. La versione 2.2.2 e successive reintroducono il supporto per questa funzionalità.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.1.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.1.3  |   Questa versione non è più disponibile, tranne nelle regioni Stati Uniti orientali (Ohio), Canada (Centrale) e AWS GovCloud (Stati Uniti orientali). Questa versione del componente richiede la versione Java 11 o successiva per funzionare. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.1.1  |  Correzioni di bug e miglioramenti.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-publisher-component.html)  | 
|  2.0.2  |  Correzioni di bug e miglioramenti.  | 
|  2.0.1  |  Versione iniziale.  | 

## Consulta anche
<a name="iotsitewise-publisher-component-see-also"></a>
+ [Che cos'è AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) nella *Guida AWS IoT SiteWise per l'utente*.

# SiteWise Processore IoT
<a name="iotsitewise-processor-component"></a>

Il componente SiteWise del processore IoT (`aws.iot.SiteWiseEdgeProcessor`) consente ai gateway AWS IoT SiteWise Classic Stream V2 di elaborare i dati all'edge.

Con questo componente, i AWS IoT SiteWise gateway possono utilizzare modelli e asset di asset per elaborare i dati sui dispositivi gateway. Per ulteriori informazioni sui AWS IoT SiteWise gateway, consulta [Using AWS IoT SiteWise at the edge nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) per l'*AWS IoT SiteWise utente*.

**Nota**  
La funzionalità Data Processing Pack (DPP) non sarà più disponibile ai nuovi clienti a partire dal 7 novembre 2025. Se desideri utilizzare il DPP, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Modifica della disponibilità del pacchetto di elaborazione dati nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html) per l'*AWS IoT SiteWise utente*.

**Topics**
+ [Versioni](#iotsitewise-processor-component-versions)
+ [Tipo](#iotsitewise-processor-component-type)
+ [Sistema operativo](#iotsitewise-processor-component-os-support)
+ [Requisiti](#iotsitewise-processor-component-requirements)
+ [Dipendenze](#iotsitewise-processor-component-dependencies)
+ [Configurazione](#iotsitewise-processor-component-configuration)
+ [File di registro locale](#iotsitewise-processor-component-log-file)
+ [Licenze](#iotsitewise-processor-component-licenses)
+ [Changelog](#iotsitewise-processor-component-changelog)
+ [Consulta anche](#iotsitewise-processor-component-see-also)

## Versioni
<a name="iotsitewise-processor-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 3.5.x
+ 3.4.x
+ 3.3.x
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="iotsitewise-processor-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-processor-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="iotsitewise-processor-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ Il dispositivo principale Greengrass deve funzionare su una delle seguenti piattaforme:
  + sistema operativo: Ubuntu 20.04 o successivo

    architettura: x86\$164 () AMD64
  + Sistema operativo: Red Hat Enterprise Linux (RHEL) 8

    architettura: x86\$164 () AMD64
  + Sistema operativo: Amazon Linux 2

    architettura: x86\$164 () AMD64
  + sistema operativo: Windows Server 2019 o versione successiva

    architettura: x86\$164 () AMD64
  + sistema operativo: Debian 11 (Bullseye) o successivo

    architettura: x86\$164 () AMD64
+ Il dispositivo principale Greengrass deve consentire il traffico in entrata sulla porta 443.
+ Il dispositivo core Greengrass deve consentire il traffico in uscita sulle porte 443 e 8883.
+ Le seguenti porte sono riservate all'uso da AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 e 50010. L'utilizzo di una porta riservata per il traffico può comportare l'interruzione della connessione.
**Nota**  
La porta 8087 è richiesta solo per la versione 2.0.15 e successive di questo componente.
+ Il [ruolo del dispositivo Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) deve disporre di autorizzazioni che consentano di utilizzare i AWS IoT SiteWise gateway sui dispositivi. AWS IoT Greengrass V2 *Per ulteriori informazioni, consulta [Requisiti nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements) per l'AWS IoT SiteWise utente.*

### Endpoint e porte
<a name="iotsitewise-processor-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `model.iotsitewise.region.amazonaws.com`  | 443 | Sì |  Ottieni informazioni sui tuoi AWS IoT SiteWise asset e sui tuoi modelli di asset.  | 
|  `edge.iotsitewise.region.amazonaws.com`  | 443 | Sì |  Ottieni informazioni sulla configurazione del AWS IoT SiteWise gateway del dispositivo principale.  | 
|  `ecr.region.amazonaws.com`  | 443 | Sì |  Scarica le immagini Docker del gateway AWS IoT SiteWise Edge da Amazon Elastic Container Registry.  | 
|  `iot.region.amazonaws.com`  | 443 | Sì |  Ottieni gli endpoint dei dispositivi per il tuo. Account AWS  | 
|  `sts.region.amazonaws.com`  | 443 | Sì |  Ottieni l'ID del tuo Account AWS.  | 
|  `monitor.iotsitewise.region.amazonaws.com`  | 443 | No |  Obbligatorio se accedi ai AWS IoT SiteWise Monitor portali sul dispositivo principale.  | 

## Dipendenze
<a name="iotsitewise-processor-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#iotsitewise-processor-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per le versioni da 2.0.x a 2.1.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | Rigidi | 
| [Stream manager](stream-manager-component.md) | >=2,0,3 =2,0,10 <3,0,0 | Rigidi | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="iotsitewise-processor-component-configuration"></a>

Questo componente non ha parametri di configurazione.

## File di registro locale
<a name="iotsitewise-processor-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait
  ```

------

## Licenze
<a name="iotsitewise-processor-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:

### Licenze di terze parti
<a name="w2ab1c24b8d120c25b5b1b1"></a>
+ Apache 2.0
+ NEBBIA
+ Clausola BSD-2
+ Clausola BSD-3
+ CDDL-1.0
+ CDDL-1.1
+ DISCO
+ Zlib
+ GPL-3.0 con eccezione GCC
+ Dominio pubblico
+ Python 2.0
+ Unicode DFS-2015
+ Clausola BSD-1
+ OpenSSL
+ EPL-1.0
+ EPL-2.0
+ GPL-2.0- with-classpath-exception
+ MPL-2,0
+ CC0-1.0
+ JSON

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="iotsitewise-processor-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 3.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html) | 
|  3.2.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  3.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  3.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  3.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  3.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  3.0.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.2.1 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.37 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.35 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.34 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.33 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.32 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.31 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.29 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.28 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.24 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.23 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.1.21  |   L'aggiornamento da 2.0.x a 2.1.x comporterà la perdita di dati locali.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.16  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  2.0.15  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.14  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  2.0.13  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.9  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.7  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.6  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.5  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
|  2.0.2  |  Versione iniziale.  | 

## Consulta anche
<a name="iotsitewise-processor-component-see-also"></a>
+ [Che cos'è AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) nella *Guida AWS IoT SiteWise per l'utente*.