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. 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 principali di Greengrass possono interagire con le ombre, vedere. Interagisci con le ombre dei dispositivi
Versioni
Questo componente ha le seguenti versioni:
Tipo
Questo componente è un componente plug-in (aws.greengrass.plugin). Il nucleo di Greengrass 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 di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.
Per ulteriori informazioni, consulta Tipi di componenti.
Sistema operativo
Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
Requisiti
Questo componente ha i seguenti requisiti:
-
(Facoltativo) Per sincronizzare le ombre con il servizio AWS IoT Device Shadow, la AWS IoT policy del dispositivo principale di Greengrass deve consentire le seguenti azioni di AWS IoT Core shadow policy:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Per ulteriori informazioni su queste AWS IoT Core politiche, consulta le azioni relative alle AWS IoT Core policy nella AWS IoT Developer Guide.
Per ulteriori informazioni sulla AWS IoT politica minima, consulta AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali
-
Il componente shadow manager è supportato per l'esecuzione in un VPC.
Dipendenze
Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT 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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
>=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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =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 |
> =2.2.0 <2.3.0 |
Flessibili |
Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti. ComponentDependencies
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 il dispositivo principale AWS IoT Core e il dispositivo principale.
Questo oggetto contiene le seguenti informazioni.
type-
(Facoltativo) Il tipo di strategia utilizzata da questo componente per sincronizzare le ombre tra il dispositivo principale 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 parametro di delay configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica la strategia di periodic sincronizzazione.
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 desideri sincronizzare lo shadow classico del dispositivo, impostalo sufalse.
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre principali dei dispositivi 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 principali. Questa shadow denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornate o eliminate questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione dell'ombra thingName per questa configurazione ombra.
classic-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con il thingName dispositivo, impostala sufalse.
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 l'ombreggiatura classica del dispositivo con il thingName dispositivo, impostalo su. false
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre denominate del dispositivo che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
direction-
(Facoltativo) La direzione per sincronizzare le ombre tra il servizio shadow locale e. 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 a e ignora gli aggiornamenti shadow dal. Cloud AWS Cloud AWS
-
cloudToDevice— Ricevi aggiornamenti shadow dal Cloud AWS e non inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza 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 requests/second
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 requests/second per ogni oggetto
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra 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 nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in. Riferimenti generali di Amazon Web Services
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni 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 utilizzata da questo componente per sincronizzare le ombre tra il dispositivo principale 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 parametro di delay configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica la strategia di periodic sincronizzazione.
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 desideri sincronizzare lo shadow classico del dispositivo, impostalo sufalse.
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre principali dei dispositivi 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 principali. Questa shadow denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornate o eliminate questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione dell'ombra thingName per questa configurazione ombra.
classic-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con il thingName dispositivo, impostala sufalse.
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 l'ombreggiatura classica del dispositivo con il thingName dispositivo, impostalo su. false
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre denominate del dispositivo che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
direction-
(Facoltativo) La direzione per sincronizzare le ombre tra il servizio shadow locale e. 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 a e ignora gli aggiornamenti shadow dal. Cloud AWS Cloud AWS
-
cloudToDevice— Ricevi aggiornamenti shadow dal Cloud AWS e non inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza 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 requests/second
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 requests/second per ogni oggetto
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra 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 nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in. Riferimenti generali di Amazon Web Services
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni 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 utilizzata da questo componente per sincronizzare le ombre tra il dispositivo principale 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 parametro di delay configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica la strategia di periodic sincronizzazione.
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 desideri sincronizzare lo shadow classico del dispositivo, impostalo sufalse.
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre principali dei dispositivi 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 principali. Questa shadow denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornate o eliminate questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione dell'ombra thingName per questa configurazione ombra.
classic-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con il thingName dispositivo, impostala sufalse.
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 l'ombreggiatura classica del dispositivo con il thingName dispositivo, impostalo 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 frequenza 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 requests/second
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni oggetto
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra 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 nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in. Riferimenti generali di Amazon Web Services
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni 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 desideri sincronizzare lo shadow classico del dispositivo, impostalo sufalse.
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre principali dei dispositivi 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 principali. Questa shadow denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornate o eliminate questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione dell'ombra thingName per questa configurazione ombra.
classic-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con il thingName dispositivo, impostala sufalse.
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 l'ombra classica del dispositivo con il thingName dispositivo, impostalo su. false
Impostazione predefinita: true
namedShadows-
(Facoltativo) L'elenco delle ombre denominate del dispositivo che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
rateLimits-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza 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 requests/second
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni oggetto
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra 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 nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in. Riferimenti generali di Amazon Web Services
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni 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.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
Changelog
La tabella seguente descrive le modifiche in ciascuna versione del componente.
|
Versione
|
Modifiche
|
|
2.3.15
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema a causa del quale lo shadow manager poteva smettere di funzionare dopo che un'interruzione di corrente danneggiava il database locale.
-
Convalida l'integrità del database locale all'avvio e ricrea il database quando rileva un danneggiamento.
|
|
2.3.14
|
Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus.
|
|
2.3.13
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema per cui gli aggiornamenti shadow locali non riuscivano a sincronizzarsi in modo intermittente con il cloud anche quando la configurazione della direzione di sincronizzazione lo consente.
-
Miglioramenti e correzioni di bug minori.
|
|
2.3.12
|
- Correzioni di bug e miglioramenti
-
|
|
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
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.7
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.6
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.5
|
Versione aggiornata per Greengrass nucleus versione 2.12.0. |
|
2.3.4
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.3
|
Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
|
2.3.2
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.1
|
- Correzioni di bug e miglioramenti
-
-
Risolve una condizione che potrebbe impedire la sincronizzazione degli aggiornamenti di Cloud Shadow.
-
Risolve un problema per cui le modifiche alla configurazione denominata shadow sync si applicano a una sola shadow denominata.
|
|
2.3.0
|
- Correzioni di bug e miglioramenti
-
|
|
2.2.4
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema per cui la convalida della dimensione dello shadow non era coerente con quella del cloud durante l'aggiornamento del documento shadow locale.
-
Risolve un problema a causa del quale lo shadow manager interrompe l'ascolto degli aggiornamenti di configurazione se una distribuzione esegue un comando RESET sui nodi di configurazione.
|
|
2.2.3
|
Versione aggiornata per Greengrass nucleus versione 2.9.0. |
|
2.2.2
|
Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. |
|
2.2.1
|
Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.
|
|
2.2.0
|
- Nuove funzionalità
-
-
Aggiunge il supporto per il servizio shadow locale sull'interfaccia locale. publish/subscribe Ora puoi comunicare con il broker di publish/subscribe messaggi locale su argomenti shadow MQTT per ottenere, aggiornare ed eliminare le ombre sul dispositivo principale. Questa funzionalità consente di connettere i dispositivi client al servizio shadow locale utilizzando il bridge MQTT per inoltrare messaggi su argomenti ombra tra i dispositivi client e l'interfaccia locale. publish/subscribe
Questa funzionalità richiede la versione 2.6.0 o successiva del componente Greengrass nucleus. Nucleo di Greengrass Per connettere i dispositivi client allo shadow service locale, è necessario utilizzare anche la versione 2.2.0 o successiva del componente bridge MQTT. Ponte MQTT
-
Aggiunge l'directionopzione che è possibile configurare per personalizzare la direzione per sincronizzare le ombre tra il servizio shadow locale e. Cloud AWSÈ possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni a. Cloud AWS
|
|
2.1.1
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema per cui la profondità massima nelle reported sezioni desired e nel documento sullo stato ombra del dispositivo JSON era di 4 livelli anziché 5 livelli.
-
Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.
|
|
2.1.0
|
|
|
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
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema che faceva sì che Shadow Manager cancellasse le versioni appena create di qualsiasi shadow precedentemente cancellata.
-
Aggiorna l'operazione DeleteThingShadow IPC per incrementare la versione shadow quando viene richiamata.
|
|
2.0.3
|
Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.
|
|
2.0.2
|
- Correzioni di bug e miglioramenti
-
-
È stato risolto un problema per il quale Shadow Manager non riconosceva la delta proprietà durante la sincronizzazione degli stati ombra da. AWS IoT Core
-
È stato risolto un problema che a volte causava l'errata unione delle richieste di sincronizzazione per un'ombra.
|
|
2.0.1
|
Versione aggiornata per Greengrass nucleus versione 2.3.0.
|
|
2.0.0
|
Versione iniziale.
|
