View a markdown version of this page

Gestore delle ombre - AWS IoT Greengrass

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 AWS IoT Servizio Device Shadow.

Per ulteriori informazioni su come i dispositivi principali di Greengrass possono interagire con le ombre, consulta Interagisci con le ombre dei dispositivi.

Versioni

Questo componente ha le seguenti versioni:

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Questo componente è un componente plug-in (aws.greengrass.plugin). Il Nucleo 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:

  • Linux

  • Windows

Requisiti

Questo componente ha i seguenti requisiti:

  • (Facoltativo) Per sincronizzare le ombre con AWS IoT Servizio Device Shadow, il dispositivo principale di Greengrass AWS IoT la policy deve consentire quanto segue AWS IoT Core azioni politiche ombra:

    • iot:GetThingShadow

    • iot:UpdateThingShadow

    • iot:DeleteThingShadow

    Per ulteriori informazioni su queste AWS IoT Core politiche, vedere AWS IoT Core azioni politiche nel AWS IoT Guida per gli sviluppatori.

    Per ulteriori informazioni sul minimal AWS IoT politica, vedere 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 si distribuisce un componente, AWS IoT Greengrass distribuisce anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuirlo correttamente. Questa sezione elenca le dipendenze per versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nel AWS IoT Greengrass plancia. Nella pagina dei dettagli del componente, cerca Dipendenze elenco.

2.3.15

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.19.0 Flessibili
2.3.14

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.18.0 Flessibili
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, consulta la riferimento alla ricetta dei componenti.

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 utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:

  • realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.

  • periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.

Impostazione predefinita: realTime

delay

(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.

Nota

Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.

synchronize

(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.

Nota

È 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 la classica modalità shadow del dispositivo, impostala su false.

Impostazione predefinita: true

namedShadows

(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.

avvertimento

Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate 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 di shadowDocuments oggetto.

Nota

Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.

Ogni oggetto contiene le seguenti informazioni:

thingName

La configurazione delle ombre per thingName per questa configurazione delle ombre.

classic

(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo 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 di utilizzare il shadowDocumentsMap parametro invece.

Nota

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

direction

(Facoltativo) La direzione per sincronizzare le ombre tra il servizio ombra locale e Cloud AWS. È possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni al Cloud AWS. Seleziona una delle opzioni seguenti:

  • betweenDeviceAndCloud — Sincronizza le ombre tra il servizio ombra locale e il Cloud AWS.

  • deviceToCloud — Inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS e ignora gli aggiornamenti shadow provenienti da Cloud AWS.

  • cloudToDevice — Ricevi aggiornamenti ombra da Cloud AWS e non inviate 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.

Predefinito: 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 cosa

Nota

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 AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API 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 AWS IoT Device Shadow Service API nel 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 AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:

  • realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.

  • periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.

Impostazione predefinita: realTime

delay

(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.

Nota

Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.

synchronize

(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.

Nota

È 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 la classica modalità shadow del dispositivo, impostala su false.

Impostazione predefinita: true

namedShadows

(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.

avvertimento

Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate 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 di shadowDocuments oggetto.

Nota

Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.

Ogni oggetto contiene le seguenti informazioni:

thingName

La configurazione delle ombre per thingName per questa configurazione delle ombre.

classic

(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo 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 di utilizzare il shadowDocumentsMap parametro invece.

Nota

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

direction

(Facoltativo) La direzione per sincronizzare le ombre tra il servizio ombra locale e Cloud AWS. È possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni al Cloud AWS. Seleziona una delle opzioni seguenti:

  • betweenDeviceAndCloud — Sincronizza le ombre tra il servizio ombra locale e Cloud AWS.

  • deviceToCloud — Inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS e ignora gli aggiornamenti shadow provenienti da Cloud AWS.

  • cloudToDevice — Ricevi aggiornamenti ombra da Cloud AWS e non inviate 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.

Predefinito: 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 cosa

Nota

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 AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API 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 AWS IoT Device Shadow Service API nel 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 AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:

  • realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.

  • periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.

Impostazione predefinita: realTime

delay

(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.

Nota

Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.

synchronize

(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.

Nota

È 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 la classica modalità shadow del dispositivo, impostala su false.

Impostazione predefinita: true

namedShadows

(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.

avvertimento

Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate 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 di shadowDocuments oggetto.

Nota

Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.

Ogni oggetto contiene le seguenti informazioni:

thingName

La configurazione delle ombre per thingName per questa configurazione delle ombre.

classic

(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo 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 di utilizzare il shadowDocumentsMap parametro invece.

Nota

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

Predefinito: 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 cosa

Nota

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 AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API 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 AWS IoT Device Shadow Service API nel 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.

Nota

È 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 la classica modalità shadow del dispositivo, impostala su false.

Impostazione predefinita: true

namedShadows

(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.

avvertimento

Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate 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 di shadowDocuments oggetto.

Nota

Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.

Ogni oggetto contiene le seguenti informazioni:

thingName

La configurazione delle ombre per thingName per questa configurazione delle ombre.

classic

(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo 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 di utilizzare il shadowDocumentsMap parametro invece.

Nota

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

Predefinito: 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 cosa

Nota

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 AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API 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 AWS IoT Device Shadow Service API nel 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 Nucleo di Greengrass componente.

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:\greengrass\v2 con il percorso verso il AWS IoT Greengrass cartella 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 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 a causa del quale 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
  • Risolve un problema a causa del quale le distribuzioni venivano bloccate quando erano configurate più di 1024 ombre dei dispositivi.

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
  • Risolve un problema per cui lo shadow manager crea una situazione di deadlock durante la connessione del client MQTT.

2.3.7

Correzioni di bug e miglioramenti
  • Risolve un problema a causa del quale Shadow Manager registra periodicamente un NullPointerException errore durante la sincronizzazione di uno shadow manager.

2.3.6

Correzioni di bug e miglioramenti
  • Risolve un problema a causa del quale le proprietà shadow che vengono eliminate tramite Cloud AWS gli aggiornamenti mentre il dispositivo è offline continuano a esistere nell'ombra locale dopo aver ripristinato la connettività.

2.3.5

Versione aggiornata per Greengrass nucleus versione 2.12.0.

2.3.4

Correzioni di bug e miglioramenti
  • Aggiunge il supporto per documenti sullo stato ombra nulli e vuoti.

2.3.3

Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.3.2

Correzioni di bug e miglioramenti
  • Risolve un problema a causa del quale Shadow Manager entra in BROKEN stato in cui il database shadow locale è danneggiato.

  • Versione aggiornata per Greengrass nucleus versione 2.10.0.

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
  • Risolve un problema che poteva impedire la sincronizzazione delle ombre quando la chiave privata del dispositivo Greengrass è archiviata in un modulo di sicurezza hardware.

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 RESET sui nodi di configurazione.

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 la versione 2.7.0 di Greengrass nucleus.

2.2.0

Nuove funzionalità
  • Aggiunge il supporto per il servizio ombra locale rispetto a quello locale publish/subscribe interfaccia. Ora puoi comunicare con il locale publish/subscribe broker di messaggi attivo 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 il locale publish/subscribe interfaccia.

    Questa funzionalità richiede la versione 2.6.0 o successiva di Componente del nucleo di Greengrass. Per connettere i dispositivi client al servizio shadow locale, è necessario utilizzare anche la versione 2.2.0 o successiva di Componente bridge MQTT.

  • Aggiunge direction opzione 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 al Cloud AWS.

2.1.1

Correzioni di bug e miglioramenti
  • Risolve un problema in cui la profondità massima nel desired e reported le sezioni del documento sullo stato ombra del dispositivo JSON erano a 4 livelli anziché a 5 livelli.

  • Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.1.0

Nuove funzionalità
  • Aggiunge il supporto per intervalli periodici di sincronizzazione shadow, in modo da poter configurare il dispositivo principale per ridurre l'utilizzo della larghezza di banda e i costi.

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 il DeleteThingShadow Operazione IPC per incrementare la versione shadow quando viene chiamata.

2.0.3

Versione aggiornata per Greengrass nucleus versione 2.4.0.

2.0.2

Correzioni di bug e miglioramenti
  • È stato risolto un problema per il quale Shadow Manager non riconosceva il delta proprietà durante la sincronizzazione degli stati ombra da AWS IoT Core.

  • È stato risolto un problema che a volte causava l'unione errata delle richieste di sincronizzazione per uno shadow.

2.0.1

Versione aggiornata per Greengrass nucleus versione 2.3.0.

2.0.0

Versione iniziale.