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à.
# Gestore delle ombre
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
Questo componente ha le seguenti versioni:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Tipo
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.
Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).
Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).
## Sistema operativo
Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows
## Requisiti
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
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
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
------
#### [ 2.3.x ]
`strategy`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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`
(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
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
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 | [\[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 | [\[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. |